Платформа Instagram

IG Container

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

Создание

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

Чтение

GET /{instagram-container-id}

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

Требования

ТипОписание

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

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

Разрешения

instagram_basic
instagram_content_publish
pages_read_engagement


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


ads_management;
business_management.

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

GET https://graph.facebook.com/{instagram-container-id}
  ?fields={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, в примерах кода представленный как {instagram-container-id}

status

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

status_code

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


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

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

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

Ответ

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

{
  "{field}":"{value}",
  ...
}

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

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

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

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

Обновление

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

Удаление

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