Instagram 容器

表示用于发布 Instagram 帖子的媒体容器。请参阅内容发布指南,查看完整的发布步骤。

创建

不支持此操作。

读取

GET /{instagram-container-id}

获取 Instagram 容器的字段连线

要求

类型描述

访问口令

用户

权限

instagram_basic
instagram_content_publish
pages_read_engagement


若通过商务管理平台向应用用户授予了公共主页身份,您还将需要以下其中一项权限:


ads_management
business_management

请求语法

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

查询字符串参数

参数

access_token
必要
字符串

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

fields
逗号分隔列表

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

字段

字段名称描述

copyright_check_status

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

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

id

Instagram 容器编号,在代码示例中表现为 {instagram-container-id}

status

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

status_code

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


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

连线

此节点没有连线。

响应

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

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

请求示例

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

响应示例

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

更新

不支持此操作。

删除

不支持此操作。