Instagram 用户提及的评论

返回特定 Instagram 评论的数据，此类评论中某个 Instagram 用户 @提及了另一位 Instagram 用户。

创建

不支持此操作。

读取

GET /{ig-user-id}?fields=mentioned_comment.comment_id

返回特定 Instagram 评论的数据，此类评论中某个 Instagram 用户 @提及了另一位 Instagram 用户。

限制

如果针对 @提及了 Instagram 用户的 Instagram 媒体的评论功能受到禁用，则此端点将返回错误。

要求

类型描述

类型	描述
访问口令	用户
权限	`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_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

查询字符串参数

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

字段

字段	描述
`id` 默认字符串	Instagram 评论的编号。
`like_count` 字符串	Instagram 评论的点赞数。
`media` 字符串	受到评论的 Instagram 媒体的编号。使用字段扩展获取返回的 Instagram 媒体条目的其他字段。
`text` 默认字符串	Instagram 评论的文本。
`timestamp` 默认字符串	以符合 ISO 8601 的格式表示 Instagram 评论的创建日期。

响应

请求示例

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

响应示例

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

字段扩展

您可以借助 Instagram 媒体字段扩展列表扩展 media 字段，以获取受到评论的 Instagram 媒体条目的其他数据。例如：

media{id,media_url}

在 2021 年 9 月 7 日前，对于 10.0 及以下版本的调用：如果多媒体素材的所有者已隐藏相关内容获得的点赞数量，则 Instagram 媒体上的 like_count 字段现将返回 0。

在 2021 年 9 月 7 日前，对于 11.0 及以上版本的调用和所有版本：如果通过另一个端点或字段扩展间接查询 Instagram 媒体，则在多媒体素材拥有者已隐藏获赞数的情况下，API 响应将忽略 like_count 字段。若是直接查询 Instagram 媒体（只能由 Instagram 媒体所有者进行），即使已隐藏获赞数，系统仍会返回实际的获赞数。

字段扩展示例请求

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

字段扩展示例响应

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "id": "17841405309211844"
}

分页

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

更新

不支持此操作。

删除

不支持此操作。