Instagram (IG) 评论

表示对 Instagram 媒体对象的评论。

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

本文将介绍以下字段：

legacy_instagram_comment_id

不支持下列字段：

comment_type
mentioned_instagram_users

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_manage_comments`	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read`

创建

不支持此操作。

读取

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

获取 Instagram 评论的字段和连线。

限制

除非是由评论的所有者发出的请求，否则无法对通过提及 API 发现的评论执行请求。请改用“提及的评论”节点。
系统不会返回对有年龄限制的媒体所作的评论。
除非 Instagram 用户不受限制并且评论已经过审核，否则系统将不会返回由应用用户加以限制的 Instagram 用户所创建的评论。
仅在所创建评论针对的 Instagram 媒体正在直播时，才可以读取直播视频 Instagram 媒体的评论。

请求语法

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

路径参数

占位符	值
`<API_VERSION>`	API 版本。
`<HOST_URL>`	API 版本。
`<IG_COMMENT_ID>`	必要。Instagram 评论编号。

查询字符串参数

键	占位符	值
`access_token`	`<ACCESS_TOKEN>`	必要。应用用户的用户访问口令。
`fields`	`<LIST_OF_FIELDS>`	您希望系统针对结果集中的每条 Instagram 评论返回的以英文逗号分隔的 Instagram 评论字段列表。

字段

字段名称	描述
`from`	对象包括： `id` — 创建 Instagram 评论的 Instagram 用户的 Instagram 范围编号 (IGSID)。 `username` — 创建 Instagram 评论的 Instagram 用户的账号。
`hidden`	指示评论是 (`true`) 否 (`false`) 已隐藏。
`id`	Instagram 评论编号。
`like_count`	Instagram 评论点赞数。
`legacy_instagram_comment_id`	为市场营销 API 端点 v21.0 和更早版本建立的 Instagram 评论编号。
`media`	对象包括： `id` — Instagram 评论所在 Instagram 媒体的编号。 `media_product_type` — Instagram 评论所在 Instagram 媒体的发布平台（即 Instagram 媒体的所在位置）。
`parent_id`	如果此评论是在另一条 Instagram 评论上创建（即对另一条评论的回复），则此为父 Instagram 评论的编号。
`replies`	对 Instagram 评论的回复（Instagram 评论）列表。
`text`	Instagram 评论文本。
`timestamp`	ISO 8601 格式的时间戳，表明 Instagram 评论的创建时间。示例：`2017-05-19T23:27:28+0000`。
`user`	创建 Instagram 评论的 Instagram 用户的编号。仅在 Instagram 评论由应用用户创建时返回，否则将返回 `username` 字段。
`username`	创建 Instagram 评论的 Instagram 用户的帐号。自 2024 年 8 月 27 日起，如果某个 Instagram 用户评论了某个应用用户 Instagram 专业账户的媒体，则您必须获得 `instagram_manage_comments` 权限（如果您的应用使用 Facebook 登录）和 `instagram_business_manage_comments` 权限（如果您的应用使用 Instagram 登录），才能访问此 Instagram 用户的 `username` 字段。

连线

连线	描述
`replies`	获取对 Instagram 评论的 Instagram 评论列表；创建对某条 Instagram 评论的 Instagram 评论。

响应

JSON 格式的对象包含默认和请求的字段和连线。

{
  "<FIELD>":"<VALUE>",
  ...
}

cURL 示例

请求

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

响应

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

更新

隐藏/取消隐藏评论

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

查询字符串参数

hide（必要项）— 如要隐藏评论，请将其设置为 true；如要显示评论，请将其设置为 false。

限制

系统将始终显示媒体对象所有者对自身媒体对象所作的评论，即使已将评论设置为 hide=true 亦是如此。
不支持对直播视频 Instagram 媒体的评论。

访问口令

被评论媒体对象的所有者用户的用户访问口令。

请求示例

隐藏评论：

POST graph.instagram.com
  /17873440459141021?hide=true

响应示例

{
  "success": true
}

删除

删除评论

DELETE <HOST_URL>/<IG_COMMENT_ID>

访问口令

由创建评论的用户提供的用户访问口令。

限制

评论只能由评论对象的所有者删除，即使是评论的作者，也无法删除评论。
不支持对直播视频 Instagram 媒体的评论。

请求示例

DELETE graph.instagram.com
  /17873440459141021

响应示例

{
  "success": true
}