File phương tiện

Biểu thị hình ảnh, video hoặc album.

Tạo

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

Đọc

GET /{media-id}

Lấy các Trường và Cạnh từ hình ảnh, video hoặc album.

Yêu cầu

Loại	Yêu cầu
Mã truy cập	Người dùng Instagram
Quyền	`instagram_graph_user_media`

Cú pháp yêu cầu

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

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óa	Giá 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 phân tách bằng dấu phẩy bao gồm các trường và cạnh mà bạn muốn nhận được. Nếu bạn bỏ qua, các trường mặc định sẽ được trả về.

Trường

Bạn có thể sử dụng thông số chuỗi truy vấn fields để yêu cầu các trường sau đây từ File phương tiện.

Tên trường	Mô tả
`caption`	Nội dung chú thích của File phương tiện. Không thể trả về đối với File phương tiện trong album.
`id`	ID File phương tiện.
`is_shared_to_feed`	Chỉ dành cho Thước phim. Nếu giá trị là `true` thì thước phim sẽ hiển thị trong cả tab Bảng feed lẫn tab Reels. Nếu giá trị là `false` thì thước phim chỉ có thể hiển thị trong tab Reels. Không có giá trị nào xác định liệu thước phim có thực sự hiển thị trong tab Reels hay không vì thước phim đó có thể không đủ điều kiện hoặc không được thuật toán của chúng tôi chọn. Hãy xem phần quy cách thước phim để biết tiêu chí đủ điều kiện.
`media_type`	Loại File phương tiện. Có thể là `IMAGE`, `VIDEO` hoặc `CAROUSEL_ALBUM`.
`media_url`	URL của File phương tiện.
`permalink`	URL vĩnh viễn của File phương tiện. URL này sẽ được bỏ qua nếu File phương tiện chứa tài liệu có bản quyền hoặc bị gắn cờ là vi phạm bản quyền.
`thumbnail_url`	URL hình thu nhỏ của File phương tiện. Chỉ có trên File phương tiện `VIDEO`.
`timestamp`	Ngày đăng File phương tiện ở định dạng ISO 8601.
`username`	Tên người dùng của chủ sở hữu File phương tiện.

Cạnh

Bạn có thể yêu cầu các cạnh sau đây ở dạng thông số đường dẫn hoặc bằng cách sử dụng thông số chuỗi truy vấn fields.

Cạnh	Mô tả
`children`	Lấy danh sách File phương tiện từ album File phương tiện. Chỉ có trên File phương tiện `CAROUSEL_ALBUM`.

Phản hồi

Một đối tượng ở định dạng JSON chứa các trường và cạnh mặc định cũng như theo yêu cầu.

{
  "{field}":"{value}",
  ...
}

cURL mẫu

Yêu cầu

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Phản hồi

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

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ợ.