Instagram 影音内容

表示 Instagram 相册、照片或视频（已上传的视频、直播视频、Reels 或快拍）。

本文将介绍以下字段：

• legacy_instagram_media_id

不支持以下市场营销 API Instagram 广告端点字段：

• filter_name
• location
• location_name
• latitude
• longitude

创建

不支持此操作。

读取

GET /<IG_MEDIA_ID>

获取 Instagram 影音内容的字段和连线。

要求

限制

• comments_count 和 like_count 等字段仅返回目标 Instagram 影音内容的互动量，不包括来自其他界面的数据。例如，comments_count 会返回照片的评论量，但不会计算包含该照片的广告的评论量。使用 total_comments_count 和 total_like_count 可获取包括推广/速推/广告影音内容互动在内的汇总计数。如果会话用户有权访问某个交叉发布的 Facebook 帖子，则该帖子的计数也可能包含在内。
• 除非应用用户也可在应用上执行管理员级别的任务，否则配文将不包含 @ 符号。
• 某些字段（如 permalink）不适用于相册中的照片（子媒体）。
• 直播视频 Instagram 影音内容仅在直播时才能读取。
• 此 API 仅返回 Instagram 专业账户所拥有影音内容的数据，无法用来获取 Instagram 个人账户所拥有影音内容的数据。
• reposts_count、saved_count、shares_count、total_like_count、total_comments_count 和 total_views_count 字段不适用于轮播子级影音内容，仅为顶层影音内容对象返回。影音内容所有者可以禁用对点赞数、评论数、浏览量、转发次数和分享次数的显示。在这些情况下，系统不会返回相应的字段。

请求语法

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

路径参数

查询字符串参数

字段

可通过字段扩展读取的公开字段。

连线

可通过字段扩展返回的公开连线。

cURL 示例

请求示例

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

响应示例

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

更新

POST /<IG_MEDIA_ID>

启用或禁用对 Instagram 影音内容的评论。

限制

不支持直播视频 Instagram 影音内容。

请求语法

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

路径参数

查询字符串参数

cURL 示例

请求示例

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

响应示例

{
  "success": true
}

删除

DELETE /<IG_MEDIA_ID>

删除 Instagram 影音内容。

要求

限制

此 API 仅支持设置了 Facebook 登录的 Instagram API。支持非广告帖子、快拍、Reels 和整个轮播相册。如要删除轮播相册中的影音内容，必须指定轮播容器影音内容编号，以删除整个轮播相册。不支持单独删除轮播容器中的影音内容。

请求语法

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

路径参数

查询字符串参数

cURL 示例

请求示例

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

响应示例（成功）

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

响应示例（失败，影音内容类型不受支持）

{
  "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"
  },
}