Graph API для Instagram

Соавторы

Представляет список пользователей, добавленных в качестве соавтором для объекта IG Media.

Создание

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

Чтение

Получение списка пользователей Instagram, которые являются соавторами, и статуса их приглашения к соавторству для объекта IG Media.

GET /{ig-media-id}

Ограничения

  • В качестве соавторов можно добавить до 3 пользователей Instagram.
  • В ответе возвращаются только пользователи Instagram, которые включили отметку в качестве соавторов.
  • Отметка в качестве соавторов поддерживается для изображений в Ленте, видео Reels и кольцевых галерей, истории не поддерживаются.

Требования

ТипОписание

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

Пользователь — пользователь должен создать объект IG Media.

Разрешения

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management;
business_management

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

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

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

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

Параметры пути

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

{api-version}

Версия API.

{ig-user-id}

Обязательный параметр. ID пользователя IG User.

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

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

access_token

{access-token}

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

Поля ответа

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

id

ID внутри приложения для аккаунта Instagram потенциального соавтора.

invite_status

Статус приглашения, отправленного потенциальному соавтору. Возможные значения:

  • Accepted;
  • Declined;
  • Pending.

username

Имя пользователя профиля Instagram потенциального соавтора.

Обновление

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

Удаление

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