File phương tiện trên Instagram

Biểu thị album, ảnh hoặc video (video đã tải lên, video trực tiếp, thước phim hoặc tin) trên Instagram.

Ra mắt trường sau đây:

• legacy_instagram_media_id

Sau đây là các trường không được hỗ trợ cho điểm cuối Quảng cáo trên Instagram thông qua API Marketing:

• filter_name
• location
• location_name
• latitude
• longitude

Tạo

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

Đọc

GET /<IG_MEDIA_ID>

Lấy các trường và cạnh trong file phương tiện trên Instagram.

Yêu cầu

Giới hạn

• Các trường như comments_count và like_count chỉ trả về lượt tương tác cho file phương tiện mục tiêu trên Instagram và không bao gồm dữ liệu từ các giao diện khác. Ví dụ: comments_count sẽ trả về số bình luận trên ảnh, chứ không trả về số bình luận trên quảng cáo chứa ảnh đó. Hãy sử dụng total_comments_count và total_like_count để lấy số lượng tổng hợp bao gồm cả lượt tương tác từ file phương tiện được quảng bá/tăng cường/quảng cáo. Có thể bao gồm số lượng bài viết được đăng chéo trên Facebook nếu người dùng trong phiên có thể truy cập bài viết đó.
• Chú thích chỉ bao gồm ký hiệu @ khi người dùng ứng dụng cũng có thể thực hiện các tác vụ tương đương dành cho quản trị viên trên ứng dụng.
• Một số trường - chẳng hạn như permalink - không dùng được trên ảnh trong album (đối tượng con).
• Người dùng chỉ đọc được File phương tiện trên Instagram trong video trực tiếp khi File phương tiện đó đang được phát.
• API này chỉ trả về dữ liệu của file phương tiện do tài khoản công việc trên Instagram sở hữu. Bạn không thể dùng API này để lấy dữ liệu của file phương tiện do tài khoản cá nhân trên Instagram sở hữu.
• Các trường reposts_count, saved_count, shares_count, total_like_count, total_comments_count và total_views_count không được cung cấp cho file phương tiện con trong thẻ quay vòng, mà chỉ được trả về cho đối tượng file phương tiện cấp cao nhất. Chủ sở hữu file phương tiện có thể tắt tính năng hiển thị số lượt thích, bình luận, lượt xem, lượt đăng lại và lượt chia sẻ. Trong những trường hợp này, hệ thống sẽ không trả về các trường tương ứng.

Cú pháp yêu cầu

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

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

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

Trường

Bạn có thể đọc các trường công khai qua tính năng mở rộng trường.

Cạnh

Các cạnh công khai có thể được trả về thông qua tính năng mở rộng trường.

cURL mẫu

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Cập nhật

POST /<IG_MEDIA_ID>

Bật hoặc tắt bình luận về một File phương tiện trên Instagram.

Giới hạn

Không hỗ trợ File phương tiện trên Instagram chứa video trực tiếp.

Cú pháp yêu cầu

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

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

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

cURL mẫu

Yêu cầu mẫu

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Phản hồi mẫu

{
  "success": true
}

Xóa

DELETE /<IG_MEDIA_ID>

Xóa file phương tiện trên Instagram.

Yêu cầu

Giới hạn

API này chỉ hỗ trợ API Instagram qua phương thức Đăng nhập bằng Facebook. Bài viết, Tin, Reels không phải quảng cáo và toàn bộ album quay vòng đều được hỗ trợ. Để xóa file phương tiện trong album quay vòng, bạn phải xóa toàn bộ album quay vòng đó bằng cách chỉ định ID file phương tiện vùng chứa của album quay vòng. Không hỗ trợ xóa từng file phương tiện trong thẻ quay vòng.

Cú pháp yêu cầu

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

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

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

cURL mẫu

Yêu cầu mẫu

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Ví dụ về phản hồi (Thành công)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Phản hồi mẫu (Không thành công, Không hỗ trợ loại file phương tiện)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}