File phương tiện

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

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 dành cho 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 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. Lưu ý: Khi sử dụng biểu tượng cảm xúc trong chú thích, bạn nên dùng định dạng mã hóa UTF-8. Số lượng ký tự có thể bị ảnh hưởng tùy theo biểu tượng cảm xúc được sử dụng.
`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 có thể 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 theo tiêu chuẩn 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ợ.