Упоминание в медиаобъекте

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

Создание

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

Чтение

GET /{ig-user-id}?fields=mentioned_media.media_id

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

Ограничения

Упоминания в историях не поддерживаются.
Возможность оставлять комментарии к фото, в которых отмечен ваш аккаунт, не поддерживается.
Webhooks не отправляются, если медиаобъект был создан закрытым аккаунтом.

Требования

Тип Описание

Тип	Описание
Маркеры доступа	Пользователь
Разрешения	`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_media.media_id({media-id}){{fields}}
  &access_token={access-token}

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

Параметр	Значение
`{access_token}` Обязательный Строка	Маркер доступа пользователя, принадлежащий пользователю приложения.
`{fields}` Список значений через запятую	Разделенный запятыми список полей объекта IG Media, которые нужно вернуть. Если его не задать, будут возвращены поля по умолчанию.
`{media-id}` Обязательный Строка	ID объекта IG Media, в подписи к которому @упомянут пользователь IG User. Этот ID содержится в полезных данных уведомления Webhook.

Поля

Поле	Описание
`caption` Строка	Текст подписи. Подпись, которая содержит @упоминание пользователя IG User, включает символ `@`, только если пользователь приложения создал объект IG Media с этим текстом.
`comments` Объект	Список комментариев IG Comment к объекту IG Media. Если для получения текста комментария используется расширение поля, текст, который содержит @упоминание пользователя IG User, включает символ `@`, только если пользователь приложения создал объект IG Media с этим текстом.
`comments_count` Строка	Количество комментариев IG Comment к объекту IG Media.
`id` Значение по умолчанию Строка	ID объекта IG Media.
`like_count` Строка	Количество отметок "Нравится", поставленных медиафайлу. Отметки "Нравится" для дочерних медиафайлов альбомов и продвигаемых публикаций, основанных на медиафайле, исключаются. Ответы на комментарии учитываются. Для вызовов версии 10.0 и более ранних: если владелец медиафайла скрыл количество отметок "Нравится" для него, возвращается значение `0`. Для вызовов версии 11.0 и более поздних: если владелец медиафайла скрыл количество отметок "Нравится" для него, это поле отсутствует. Если владелец медиафайла скрыл количество отметок "Нравится" для него, возвращается значение `0`.
`media_type` Строка	Тип объекта IG Media: `CAROUSEL_ALBUM`, `IMAGE`, `STORY` или `VIDEO`.
`media_url` Строка	URL опубликованного объекта IG Media.
`owner` Строка	ID пользователя IG User, который создал объект IG Media. Возвращается, только если этот объект IG Media создал пользователь приложения. В противном случае возвращается поле `username`.
`timestamp` Строка	Дата создания объекта IG Media в формате ISO 8601.
`username` Строка	Имя пользователя IG User, создавшего объект IG Media.

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

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

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

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Обратите внимание, что в примере выше API удалил начальный символ @ из исходной подписи (@metricsaurus headquarters!), потому что пользователь приложения не создавал ее.

Разбивка на страницы

Если расширение поля используется для доступа к границе контекста, которая поддерживает разбивку на страницы с использованием курсора, ответ содержит курсоры before и after (если возвращаемые данные состоят из нескольких страниц). В отличие от стандартной разбивки на страницы с использованием курсора, ответ не содержит полей previous и next, поэтому вам потребуется вручную строить строки запроса previous и next с помощью курсоров before и after для перехода по страницам полученного набора данных.

Обновление

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

Удаление

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