Vùng chứa trên Instagram (IG)

Biểu thị một vùng chứa file phương tiện để đăng đối tượng file phương tiện trên Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

Tạo

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

Đọc

GET <HOST_URL>/<IG_CONTAINER_ID>

Lấy các trườngcạnh trong một Vùng chứa trên Instagram.

Cú pháp yêu cầu

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

Thông sốGiá trị

access_token
Bắt buộc
String

Mã truy cập dành cho Người dùng 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ườngcạ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

Tên trườngMô tả

copyright_check_status

Được dùng để xác định xem video đã tải lên có vi phạm bản quyền hay không. Cặp khóa-giá trị được trả về bao gồm:

  • matches_found được đặt là một trong những giá trị sau đây:
    • true - video vi phạm bản quyền
    • false - video không vi phạm bản quyền
  • status được đặt là một trong những giá trị sau đây:
    • completed - quá trình phát hiện đã kết thúc
    • error - đã xảy ra lỗi trong quá trình phát hiện
    • in_progress - quá trình phát hiện đang diễn ra
    • not_started - quá trình phát hiện chưa bắt đầu

id

ID vùng chứa trên Instagram, được biểu thị là <IG_CONTAINER_ID> trong mã mẫu

status

Trạng thái đăng. Nếu status_codeERROR, giá trị này sẽ là mã lỗi phụ.

status_code

Trạng thái đăng của vùng chứa. Giá trị có thể dùng:


  • EXPIRED - Vùng chứa đã hết hạn sau 24 giờ không được đăng.
  • ERROR - Vùng chứa không thể hoàn tất quá trình đăng.
  • FINISHED - Vùng chứa và đối tượng file phương tiện của vùng chứa đó đã sẵn sàng đăng.
  • IN_PROGRESS - Vùng chứa vẫn đang trong quá trình đăng.
  • PUBLISHED - Đối tượng file phương tiện của vùng chứa đã được đăng.

Cạnh

Không có cạnh nào trên nút này.

Phản hồi

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

{
  "<FIELD>":"<VALUE>",
  ...
}

Yêu cầu mẫu

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

Phản hồi mẫu

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

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