File phương tiện của người dùng

Biểu thị tập hợp File phương tiện của Người dùng.

Tạo

Thao tác này không được hỗ trợ.

Đọc

GET /{user-id}/media

Lấy tập hợp File phương tiện của Người dùng.

Các giới hạn

  • Tin không được hỗ trợ.
  • File phương tiện trong bài viết quảng cáo không được hỗ trợ.
  • Trả về tối đa 10.000 file phương tiện đã tạo gần đây nhất.

Yêu cầu

LoạiYêu cầu

Mã truy cập

Người dùng Instagram

Quyền

instagram_graph_user_media, instagram_graph_user_profile

Cú pháp yêu cầu

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

Thông số đường dẫn

Phần giữ chỗGiá trị

{api-version}
Chuỗi

Phiên bản API.

{user-id}
Bắt buộc
Chuỗi

ID người dùng trong ứng dụng của người dùng ứng dụng (phiên bản 11.0 trở lên) hoặc ID người dùng chưa xử lý (tất cả các phiên bản).

Thông số chuỗi truy vấn

Thêm các thông số chuỗi truy vấn sau đây vào yêu cầu.

KhóaGiá trị

access_token
Bắt buộc
Chuỗi

Mã truy cập người dùng Instagram của người dùng ứng dụng.

fields
Danh sách được phân tách bằng dấu phẩy

Danh sách các trường thông tin File phương tiện được phân tách bằng dấu phẩy mà bạn muốn phần mở rộng trường thông tin trả về cho từng nút File phương tiện trong nhóm kết quả.

since
nhãn thời gian

Nhãn thời gian Unix hoặc giá trị dữ liệu strtotime trỏ đến phần đầu của phạm vi dữ liệu dựa theo thời gian. Hãy xem phần phân trang theo thời gian.

until
nhãn thời gian

Nhãn thời gian Unix hoặc giá trị dữ liệu strtotime trỏ đến phần cuối của phạm vi dữ liệu dựa theo thời gian. Hãy xem phần phân trang theo thời gian.

Phản hồi

Một đối tượng ở định dạng JSON chứa dữ liệu mà bạn yêu cầu.

{
  "data": [],
  "paging": {}
}

Nội dung phản hồi

Thuộc tínhGiá trị

data

Mảng File phương tiện của Người dùng.

paging

Một đối tượng chứa các con trỏ phân trang và URL truy xuất tập dữ liệu trước/tiếp theo.

Ví dụ về cURL

Yêu cầu

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171/media?access_token=IGQVJ...'

Phản hồi

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Cập nhật

Thao tác này không được hỗ trợ.

Xóa

Thao tác này không được hỗ trợ.