Graph API для Instagram

Упоминания для IG User

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

Создание

Ответ на объект IG Media с подписью

POST /{ig-user-id}/mentions?media_id={media_id}&message={message}

Создает комментарий IG Comment к объекту IG Media, в котором пользователь IG User @упомянут в подписи.

Ограничения

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

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

Параметры строки запроса необязательны, если не указано обратное.

  • {media_id} (обязательный) — ID медиаобъекта, содержащегося в полезных данных уведомления Webhook.
  • {message} (обязательный) — текст, включаемый в комментарий.

Разрешения

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

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

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

  • ads_management
  • pages_read_engagement
  • business_management

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

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "message=Thanks%20for%20the%20dinosaur!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

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

{
  "id": "17846319838228163"
}

Ответ на комментарий

POST /{ig-user-id}/mentions?media_id={media_id}&comment_id={comment_id}&message={message}

Создает комментарий IG Comment к комментарию IG Comment, в котором @упомянут пользователь IG User.

Ограничения

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

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

Параметры строки запроса необязательны, если не указано обратное.

  • {comment_id} (обязательный) — ID комментария, содержащегося в полезных данных уведомления Webhook.
  • {media_id} (обязательный) — ID медиаобъекта, содержащегося в полезных данных уведомления Webhook.
  • {message} (обязательный) — текст, включаемый в комментарий.

Разрешения

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

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

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

  • ads_management
  • pages_read_engagement
  • business_management

Параметры

  • comment_id (обязательный)
  • media_id (обязательный)
  • message

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

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "comment_id=17918718562020960" \
 -d "message=Hope%20you%20enjoy%20your%20new%20T-Rex!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

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

{
  "id": "17846319838254687"
}

Чтение

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

Обновление

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

Удаление

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