Платформа Instagram

Instagram (IG) Comment

Представляет комментарий к медиаобъекту 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 LoginInstagram API with Facebook Login

Access Tokens

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

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

Ограничения

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

Синтаксис запроса

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>

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

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

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

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_FIELDS>

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

Поля

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

from

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

hidden

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

id

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

like_count

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

legacy_instagram_comment_id.

ID комментария в Instagram, созданный для конечных точек Marketing API для версии 21.0 и более ранних.

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.

С 27 августа 2024 г. для доступа к полю username пользователя Instagram, прокомментировавшего медиафайл пользователя приложения с профессиональным аккаунтом Instagram, потребуются разрешения instagram_manage_comments (если в приложении используется вход через Facebook) и instagram_business_manage_comments (если в приложении используется вход через Instagram).

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

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

replies

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

Ответ

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

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

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

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

Вот как можно скрыть комментарий:

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

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

{
  "success": true
}

Удаление

Удаление комментария

DELETE <HOST_URL>/<IG_COMMENT_ID>

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

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

Ограничения

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

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

DELETE graph.instagram.com
  /17873440459141021

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

{
  "success": true
}