提及的媒体

返回特定 Instagram 媒体的数据，在此媒体中，某位 Instagram 用户在说明中 @提及了另一位 Instagram 用户。

创建

不支持此操作。

读取

GET /{ig-user-id}?fields=mentioned_media.media_id

返回特定 Instagram 媒体的数据，在此媒体中，某位 Instagram 用户在说明中 @提及了另一位 Instagram 用户。

限制

不支持在快拍上提及。
不支持在带有您标签的照片上发表评论。
如果出现评论或 @提及的媒体是由设置为非公开的帐户所创建，则系统不会发送 Webhooks。

要求

类型描述

类型	描述
访问口令	用户
权限	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` 如果通过商务管理平台向应用用户授予了公共主页上的身份，您还需要以下其中一项权限： `ads_management` `business_management`
任务	`MANAGE`、`CREATE_CONTENT` 或 `MODERATE`

访问口令

用户

权限

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

如果通过商务管理平台向应用用户授予了公共主页上的身份，您还需要以下其中一项权限：

ads_management
business_management

任务

MANAGE、CREATE_CONTENT 或 MODERATE

请求语法

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

查询字符串参数

参数	值
`{access_token}` 必要字符串	应用用户的用户访问口令。
`{fields}` 逗号分隔列表	您希望系统返回的以逗号分隔的 Instagram 媒体列表。如果不指定，系统将返回默认字段。
`{media-id}` 必要字符串	其说明中 @提及了 Instagram 用户的 Instagram 媒体的编号。此编号包含在 Webhook 通知负载中。

字段

字段	描述
`caption` 字符串	说明文本。如果应用用户不是说明文字所属 Instagram 媒体对象的创建者，则 @提及 Instagram 用户的说明文字不得包含 `@` 符号。
`comments` 对象	Instagram 媒体的 Instagram 评论列表。如果要使用字段扩展获取评论文本，@提及 Instagram 用户的说明文字不得包含 `@` 符号，除非应用用户是说明文字所属 Instagram 媒体对象的创建者。
`comments_count` 字符串	Instagram 媒体的 Instagram 评论的数量。
`id` 默认字符串	Instagram 媒体的编号。
`like_count` 字符串	媒体的获赞数。不包括相册子媒体和使用此媒体创作的推广帖子获得的赞。包括对评论的赞。 v10.0 及更早版本的调用：如果媒体所有者隐藏了获赞数，则值将为 `0`。 v11.0 及以上版本的通话：如果媒体所有者隐藏了获赞数，则将省略字段，如果媒体所有者隐藏了获赞数，则值将为 `0`。
`media_type` 字符串	Instagram 媒体的类型：`CAROUSEL_ALBUM`、`IMAGE`、`STORY` 或 `VIDEO`。
`media_url` 字符串	已发布 Instagram 媒体的网址。
`owner` 字符串	创建了相应 Instagram 媒体的 Instagram 用户的编号。仅在 Instagram 媒体对象由应用用户创建时返回，否则将返回 `username` 字段。
`timestamp` 字符串	以符合 ISO 8601 的格式表示 Instagram 媒体的创建日期。
`username` 字符串	创建了相应 Instagram 媒体的 Instagram 用户的用户名。

请求示例

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

响应示例

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

请注意，在上述示例中，该 API 去掉了原始说明文字 (@metricsaurus headquarters!) 开头的 @ 符号，因为该说明文字并非由应用用户所创建。

分页

如果您使用字段扩展访问支持基于游标的分页的连线，当响应包含多页数据时，其中将包含 before 和 after 游标。与基于游标的标准分页不同，响应不会包含 previous 或 next 字段，因此，您将需要使用 before 和 after 游标手动构建 previous 和 next 查询字符串，以便翻页浏览返回的数据集。

更新

不支持此操作。

删除

不支持此操作。