Instagram 素材

表示 Instagram 相册、照片或视频（已上传的视频、直播视频、使用 Instagram TV 应用创建的视频、Reels 或快拍）。

创建

不支持此操作。

读取

GET /{ig-media-id}

获取 Instagram 媒体的字段和连线。

限制

返回总值的字段不会包括广告带来的数据。例如，comments_count 会计算照片的评论量，但不会计算包含该照片的广告的评论量。
除非应用用户也可在应用上执行管理员级别的任务，否则说明将不包含 @ 符号。
某些字段（如 permalink）不适用于相册中的照片（子媒体）。
对于 Instagram TV 媒体，必须在发布（已启用发布预览或把预览分享到动态）时将其分享至 Instagram，用户才能通过 API 进行访问。
直播视频 Instagram 媒体仅在直播时才能读取。

要求

类型描述

类型	描述
访问口令	用户。
权限	`instagram_basic` `pages_read_engagement` `pages_show_list` 如果应用用户已通过商务管理平台获得公共主页用户身份，则您还需要具备以下权限之一： `ads_management` `business_management`

访问口令

用户。

权限

instagram_basic
pages_read_engagement
pages_show_list

如果应用用户已通过商务管理平台获得公共主页用户身份，则您还需要具备以下权限之一：

ads_management
business_management

请求语法

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &access_token={access-token}

路径参数

占位符	值
`{api-version}`	API 版本。
`{ig-media-id}`	必要。Instagram 媒体编号。

查询字符串参数

键	占位符	值
`access_token`	`{access-token}`	必要。应用用户的用户访问口令。
`fields`	`{fields}`	您希望返回的以逗号分隔的字段清单。

字段

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

字段描述

caption
公开

说明。不包括相册子媒体。如果已将 Facebook 公共主页绑定到用于创建此说明的 Instagram 帐户，而应用用户无法在该公共主页上执行管理员级别的任务，则不包括 @ 符号。

comments_count
公开

针对媒体的评论数量。不包括对相册子媒体及媒体说明的评论。包括对评论的回复。

copyright_check_information.status

返回 status 和 matches_found 对象

状态对象描述

status

completed – 检测过程已结束
error – 检测过程中出现错误
in_progress – 正在检测
not_started – 检测过程尚未开始

matches_found

设为以下值之一：

false – 如果视频未侵犯版权
true – 如果视频侵犯了版权

如果视频正在侵犯版权，系统将返回 copyright_matches 和有关受版权保护材料的一组对象；如果视频中正出现违规行为，系统还将返回减轻违规影响需要采取的措施。

copyright_matches 对象	描述
`author`	受版权保护视频的作者
`content_title`	受版权保护视频的名称
`matched_segments`	包含以下键值对的一组对象：`duration_in_seconds` – 内容侵犯版权的秒数 `segment_type` – `AUDIO` 或 `VIDEO` * `start_time_in_seconds` – 设为视频的开始时间
`owner_copyright_policy`	返回的对象中包含： `name` – 版权所有者所遵循的版权保护政策名称 `actions` – 一组 `action` 对象，其中包含根据版权所有者所遵循的版权保护政策规定，为减轻违规影响而需要采取的措施。针对不同位置，可能包含不同减轻步骤。 `action` – 针对侵犯版权的视频的减轻措施。不同的国家可采取不同的减轻步骤。可以是以下值之一： `BLOCK` – 阻止 `geos` 数组中列出的受众观看某个视频 `MUTE` - 为 `geos` 数组中列出的受众关闭视频的声音

id
公开

媒体编号。

ig_id
公开

Instagram 媒体编号。用于旧版 Instagram API，现已停用。改用 id。

is_comment_enabled

表示评论处于启用还是停用状态。不包括相册子媒体。

is_shared_to_feed
公开

仅适用于 Reels。如果为 true，表示 Reels 可以同时在动态和 Reels 选项卡中显示。如果为 false，则表示 Reels 只可在 Reels 选项卡中显示。

这两个值都不表示 Reels 是否会实际显示在 Reels 选项卡中，因为 Reels 可能不符合资格要求或未被我们的算法选中。有关资格标准，请参阅 Reels 规格。

like_count

媒体的获赞数，包括对评论的赞。不包括相册子图片媒体和使用此媒体创作的推广帖子获得的赞。

如果通过其他端点或字段扩展间接查询：

v10.0 及更早版本的调用：如果媒体所有者已隐藏获赞数，则值为 0。
v11.0 及更高版本的调用：如果媒体所有者已隐藏获赞数，则将省略 like_count 字段。

media_product_type
公开

媒体的发布平台。可以是 AD、FEED、STORY 或 REELS。

media_type
公开

媒体类型。可以是 CAROUSEL_ALBUM、IMAGE 或 VIDEO。

media_url
公开

媒体网址。

如果媒体包含受版权保护的内容，或者已被标记为违反版权的内容，系统会从响应中删除 media_url 字段。在 Reels 上，受版权保护的内容示例可包含音频。

owner
公开

创建媒体的 Instagram 用户的编号。仅在发出查询请求的应用用户也是媒体的创建者时返回，否则将返回 username 字段。

permalink
公开

媒体的永久网址。

shortcode
公开

媒体的短代码。

thumbnail_url
公开

媒体缩略图网址。仅适用于 VIDEO 媒体。

timestamp
公开

ISO 8601 格式的创建日期（UTC 时间，默认值为 UTC ±00:00）。

username
公开

创建媒体的用户的帐号。

video_title
公开

已停用。已从响应中删除。

连线

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

连线	描述
`children` 公开。	表示 Instagram 媒体相册中的 Instagram 媒体对象集合。
`collaborators`	表示作为合作者添加到 Instagram 媒体对象上的用户的名单。
`comments`	表示对 Instagram 媒体对象的 Instagram 评论的集合。
`insights`	表示 Instagram 媒体对象的社交互动指标。

cURL 示例

请求

curl -X GET \
  'https://graph.facebook.com/v19.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 媒体。

要求