Платформа Instagram

IG Comment

Представляет комментарий к объекту IG Media.

Создание

Эта операция не поддерживается.

Чтение

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

Получение полей и границ контекста для IG Comment.

Ограничения

  • Запросы к комментариям при поиске через API Mentions могут выполнять только их владельцы. Если вы не являетесь владельцем комментария, воспользуйтесь узлом Mentioned Comment.
  • Комментарии к медиафайлам, доступ к которым ограничен по возрасту, не возвращаются.
  • Комментарии, оставленные пользователями IG User, для которых пользователь приложения установил ограничения, не возвращаются. Чтобы их можно было получить, ограничения должны быть сняты, а комментарии одобрены.
  • Комментарии к видео в прямом эфире IG Media можно прочитать только во время трансляции объекта IG Media, к которому они добавлены.

Требования

ТипТребование

Маркеры доступа

Пользователь

Разрешения

instagram_basic
pages_read_engagement
pages_show_list


Если пользователь приложения получил роль на Странице, связанной с целевым пользователем IG User, через Business Manager, также потребуется одно из следующих разрешений:


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}

Обязательный параметр. ID комментария IG Comment.

Параметры строки запроса

КлючЗаполнительЗначение

access_token

{access-token}

Обязательный параметр. Маркер доступа пользователя приложения.

fields

{fields}

Разделенный запятыми список полей IG Comment, которые нужно вернуть для каждого комментария IG Comment из списка результатов.

Поля

Имя поляОписание

from

Объект, содержащий следующее:


  • id — IGSID пользователя Instagram, создавшего комментарий IG Comment;
  • username — имя пользователя Instagram, создавшего комментарий IG Comment.

hidden

Указывает, скрыт ли комментарий (true — скрыт, false — не скрыт).

id

ID комментария IG Comment.

like_count

Количество отметок "Нравится" у комментария IG Comment.

media

Объект, содержащий следующее:


  • id — ID объекта IG Media, к которому добавлен комментарий IG Comment;
  • media_product_type — место публикации объекта IG Media (т. е. место, где отображается объект IG Media), к которому добавлен комментарий IG Comment.

parent_id

ID родительского комментария IG Comment, если этот комментарий был создан к другому комментарию IG Comment (т. е. в качестве ответа на него).

replies

Список ответов (комментариев IG Comment) к этому комментарию IG Comment.

text

Текст комментария IG Comment.

timestamp

Метка времени в формате ISO 8601, обозначающая дату создания комментария IG Comment.


Пример: 2017-05-19T23:27:28+0000.

user

ID пользователя IG User, который создал комментарий IG Comment. Возвращается, только если этот комментарий IG Comment создал пользователь приложения. В противном случае возвращается поле username.

username

Имя пользователя Instagram, создавшего комментарий IG Comment.

Границы контекста

Граница контекстаОписание

replies

Получение списка комментариев IG Comment к этому комментарию IG Comment. Добавление комментария IG Comment к этому комментарию IG Comment.

Ответ

Объект в формате 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.
  • Комментарии к видео в прямом эфире IG Media не поддерживаются.

Разрешения

Маркер доступа пользователя Facebook, создавшего комментарий, со следующими разрешениями:

  • instagram_basic;
  • instagram_manage_comments;
  • pages_show_list;
  • pages_read_engagement.

Если маркер доступа принадлежит пользователю, роль которого на Странице была назначена через Business Manager, также требуется одно из следующих разрешений:

  • 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;

Если маркер доступа принадлежит пользователю, роль которого на Странице была назначена через Business Manager, также требуется одно из следующих разрешений:

  • ads_management
  • pages_read_engagement
  • business_management

Ограничения

  • Удалить комментарий может только владелец объекта, к которому он оставлен. Автор комментария не может удалить его.
  • Комментарии к видео в прямом эфире IG Media не поддерживаются.

Пример запроса

DELETE graph.facebook.com
  /17873440459141021

Пример ответа

{
  "success": true
}