Instagram (IG) 容器

表示用于发布 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

创建

不支持此操作。

读取

GET <HOST_URL>/<IG_CONTAINER_ID>

获取 Instagram 容器的字段连线

请求语法

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

查询字符串参数

参数

access_token
必要
字符串

应用用户的用户访问口令。

fields
逗号分隔列表

您希望系统返回的以逗号分隔的字段连线列表。如果不指定,系统将返回默认字段。

字段

字段名称描述

copyright_check_status

用于确定上传的视频是否侵犯了版权。返回的键值对包括:

  • matches_found,设为以下值之一:
    • true – 视频侵犯了版权
    • false – 视频未侵犯版权
  • status,设为以下值之一:
    • completed – 检测过程已结束
    • error – 检测过程中出现错误
    • in_progress – 正在检测
    • not_started – 检测过程尚未开始

id

Instagram 容器编号,在代码示例中表现为 <IG_CONTAINER_ID>

status

发布状态。若 status_codeERROR,此值将为错误子代码

status_code

容器的发布状态。可能的值:


  • EXPIRED — 容器未在 24 小时内发布,已过期。
  • ERROR — 容器无法完成发布流程。
  • FINISHED — 已准备好发布容器及其素材对象。
  • IN_PROGRESS — 容器仍处于发布阶段。
  • PUBLISHED — 已发布容器的媒体对象。

连线

此节点没有连线。

响应

JSON 格式的对象,包含默认和请求的字段

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

请求示例

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

响应示例

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

更新

不支持此操作。

删除

不支持此操作。