Комментарий с упоминанием пользователя IG User

Возвращает сведения о комментарии IG Comment, в котором пользователь IG User @упоминается другим пользователем Instagram.

Создание

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

Чтение

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

Ограничения

Эта конечная точка возвращает ошибку, если комментарии к объекту IG Media, в котором @упомянут пользователь IG User, отключены.

Требования

Тип Описание

Тип	Описание
Маркеры доступа	Пользователь
Разрешения	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` Если пользователь приложения получил роль на Странице через Business Manager, также потребуются следующие разрешения: `ads_management`; `business_management`.
Задачи	`MANAGE`, `CREATE_CONTENT` или `MODERATE`

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

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

Разрешения

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

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

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}` Обязательный параметр Строка	ID комментария IG Comment, в котором @упомянут пользователь IG User. Этот ID содержится в полезных данных уведомления Webhooks.
`{fields}` Список значений через запятую	Список полей комментария IG Comment, которые нужно вернуть. Если его не задать, будут возвращены поля по умолчанию.

Поля

Поле	Описание
`id` Поле по умолчанию Строка	ID комментария IG Comment.
`like_count` Строка	Количество отметок "Нравится" для комментария IG Comment.
`media` Строка	ID объекта IG Media, к которому добавлен комментарий IG Comment. Чтобы получить дополнительные поля для возвращенного объекта IG Media, используйте расширение поля.
`text` Поле по умолчанию Строка	Текст комментария IG Comment.
`timestamp` Поле по умолчанию Строка	Дата создания комментария IG Comment в формате ISO 8601.

Ответ

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

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"
}

Расширение поля

Поле media можно расширить списком полей IG Media, чтобы получить дополнительные сведения об объекте IG Media, к которому был сделан комментарий. Пример:

media{id,media_url}

Для вызовов версии 10.0 и более ранних до 7 сентября 2021 г.: поле like_count в IG Media теперь возвращает 0, если владелец медиафайла скрыл для него количество отметок "Нравится".

Для вызовов версии 11.0 и более поздних с 7 сентября 2021 г.: при непрямом запросе объекта IG Media через другую конечную точку или расширение поля в ответе на вызов API будет отсутствовать поле like_count, если владелец медиаобъекта скрыл количество поставленных ему отметок "Нравится". При прямом запросе объекта IG Media (который может совершить только его владелец) возвращается реальное количество отметок "Нравится", даже если этот показатель был скрыт.

Пример запроса с расширением поля

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, поэтому вам потребуется вручную строить строки запроса previous и next с помощью курсоров before и after для перехода по страницам полученного набора данных.

Обновление

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

Удаление

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