Instagram (IG) Container

Представляет контейнер медиафайла для публикации объекта медиафайла в Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User 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_content_publish
  • instagram_basic
  • instagram_content_publish
  • 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_CONTAINER_ID>

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

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

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

ПараметрЗначение

access_token
Обязательный
Строка

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

fields
Список значений через запятую

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

Поля

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

copyright_check_status

Используется для определения того, нарушает ли загруженное видео авторские права. Пары "ключ-значения" возвращают параметры, среди которых:

  • matches_found имеет одно из следующих значений:
    • true — видео нарушает авторские права;
    • false — видео не нарушает авторские права;
  • status имеет одно из следующих значений:
    • completed — процесс обнаружения завершен;
    • error — в процессе обнаружения произошла ошибка;
    • in_progress — процесс обнаружения ещё идет;
    • not_started — процесс обнаружения не начат.

id

ID Instagram Container, представленный в примерах кода как <IG_CONTAINER_ID>

status

Статус публикации. Если status_code представляет собой ERROR, это значение будет подкодом ошибки.

status_code

Статус публикации контейнера. Возможные значения:


  • EXPIRED — контейнер не был опубликован в течение 24 часов и больше не действителен;
  • ERROR — контейнер не удалось опубликовать из-за ошибки;
  • FINISHED — контейнер с медиаобъектом готов к публикации;
  • IN_PROGRESS — процесс публикации контейнера ещё идет;
  • PUBLISHED — медиаобъект опубликован.

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

На этом узле границ контекста нет.

Ответ

Объект в формате JSON со стандартными и запрошенными полями.

{
  "<FIELD>":"<VALUE>",
  ...
}

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

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

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

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Обновление

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

Удаление

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