Instagram 评论

表示对 Instagram 媒体的评论。

创建

不支持此操作。

读取

GET /{ig-comment-id}?fields={fields}

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

限制

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

要求

类型要求

类型	要求
访问口令	用户
权限	`instagram_basic` `pages_read_engagement` `pages_show_list` 若在与目标 Instagram 用户关联的公共主页上，通过商务管理平台向应用用户授予身份，您还需要以下其中一项权限： `ads_management` `business_management`

访问口令

用户

权限

instagram_basic
pages_read_engagement
pages_show_list

若在与目标 Instagram 用户关联的公共主页上，通过商务管理平台向应用用户授予身份，您还需要以下其中一项权限：

ads_management
business_management

请求语法

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

路径参数

占位符	值
`{api-version}`	API 版本。
`{ig-comment-id}`	必要项。Instagram 评论编号。

查询字符串参数

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

字段

字段名称	描述
`from`	对象包括： `id` — 创建 Instagram 评论的 Instagram 用户的 IGSID。 `username` — 创建 Instagram 评论的 Instagram 用户的帐号。
`hidden`	指示评论是 (`true`) 否 (`false`) 已隐藏。
`id`	Instagram 评论编号。
`like_count`	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 用户的帐号。

连线

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

响应

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

{
  "{field}":"{value}",
  ...
}

cURL 示例

请求

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

响应

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

更新

隐藏/取消隐藏评论

POST /{ig-comment-id}?hide={hide}

查询字符串参数

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

限制

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

权限

创建评论的 Facebook 用户提供的用户访问口令包含以下权限：

instagram_basic
instagram_manage_comments
pages_show_list
pages_read_engagement

如果口令所有者的公共主页用户身份通过商务管理平台授予，则还需要下列其中一项权限：

ads_management
pages_read_engagement
business_management

请求示例

隐藏评论：

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

响应示例

{
  "success": true
}

删除

删除评论

DELETE /{ig-comment-id}

权限

创建评论的用户提供的用户访问口令包含以下权限：

instagram_basic
instagram_manage_comments

如果口令所有者的公共主页用户身份通过商务管理平台授予，则还需要下列其中一项权限：

ads_management
pages_read_engagement
business_management

限制

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

请求示例

DELETE graph.facebook.com
  /17873440459141021

响应示例

{
  "success": true
}