Платформа Instagram

IG Media

Представляет альбом, фото или видео (загруженное видео, прямой эфир, видео, созданное в приложении Instagram TV, видео Reels или историю) в Instagram.

Создание

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

Чтение

GET /{ig-media-id}

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

Ограничения

  • Поля, возвращающие совокупные значения, не содержат данные на основе рекламы. Например, в значении comments_count учитываются комментарии к фото, но не учитываются комментарии к содержащим его рекламным объявлениям.
  • Подписи не будут содержать символ @, если у пользователя в приложении нет разрешений на выполнение задач, аналогичных задачам администратора.
  • Некоторые поля, например permalink, нельзя использовать для фото в альбомах (дочерних объектов).
  • Чтобы к медиафайлу Instagram TV можно было получить доступ через API, он должен быть опубликован в Instagram (с помощью функции Опубликовать предпросмотр или Поделиться предпросмотром в Ленте).
  • Объект IG Media видео в прямом эфире можно прочитать только во время трансляции.

Требования

ТипОписание

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

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

Разрешения

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management;
business_management.

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

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &access_token={access-token}

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

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

{api-version}

Версия API.

{ig-media-id}

Обязательный параметр. ID объекта IG Media.

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

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

access_token

{access-token}

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

fields

{fields}

Список возвращаемых полей, разделенных запятыми.

Поля

Общедоступные поля могут считываться через расширение поля.

ПолеОписание

caption
Общедоступное

Подпись. Дочерние объекты альбомов исключаются. Символ @ исключается, если пользователь не может выполнять задачи уровня администратора на Странице Facebook, связанной с аккаунтом Instagram, который использовался для создания подписи.

comments_count
Общедоступное

Количество комментариев к медиафайлу. Комментарии к дочерним медиафайлам альбомов и к подписи медиафайла исключаются. Ответы на комментарии учитываются.

copyright_check_information.status

Возвращает объекты status и matches_found.

Объекты поля statusОписание

status

  • completed — процесс обнаружения завершен.
  • error — в процессе обнаружения произошла ошибка.
  • in_progress — процесс обнаружения ещё идет.
  • not_started — процесс обнаружения не начат.

matches_found

Установите одно из следующих значений:

  • false, если видео не нарушает авторские права;
  • true, если видео нарушает авторские права.

Если видео нарушает авторские права, возвращается поле copyright_matches с массивом объектов, связанных с защищенными авторским правом материалами, с тем, где именно в видео возникает нарушение и какие действия необходимо предпринять, чтобы устранить это нарушение.

Объекты поля copyright_matchesОписание

author

Автор видео, защищенного авторским правом.

content_title

Заголовок видео, защищенного авторским правом.

matched_segments

Массив объектов со следующими парами "ключ-значение": * duration_in_seconds — сколько секунд контента нарушают авторские права * segment_type — AUDIO или VIDEO * start_time_in_seconds — время начала видео.

owner_copyright_policy

Возвращаемые объекты содержат:

  • name — название политики владельца авторского права;

  • actions — массив объектов action, содержащих сведения о предпринимаемых действиях по устранению нарушения, определенных в политике владельца авторского права. Может содержать различные действия для различных местоположений.

    • action — действие по устранению нарушения авторского права, предпринятое по отношению к видео. Действия в разных странах могут различаться. Возможные значения:
      • BLOCK — видео блокируется и становится недоступным для аудиторий, перечисленных в массиве geos;
      • MUTE — в видео выключается звук для аудиторий, перечисленных в массиве geos.

id
Общедоступное

ID медиафайла.

ig_id
Общедоступное

ID медиафайла в Instagram. Используется в устаревшем API Instagram. Используйте вместо него id.

is_comment_enabled

Указывает, включены или отключены комментарии. Дочерние объекты альбомов исключаются.

is_shared_to_feed
Общедоступное

Только для видео Reels. Значение true означает, что видео Reels может появиться как на вкладке Лента, так и на вкладке Reels. Значение false означает, что видео Reels может появиться только на вкладке Reels.

Ни одно из этих значений не означает, что видео Reels действительно появится на вкладке Reels, поскольку видео Reels может не соответствовать установленным требованиям или наш алгоритм может его не выбрать. Информацию о критериях соответствия требованиям см. в требованиях к видео Reels.

like_count

Количество отметок "Нравится" для медиафайлов, включая ответы на комментарии. Отметки "Нравится" для дочерних медиафайлов альбомов и продвигаемых публикаций на базе этого медиафайла исключаются.


В случае непрямого запроса через другую конечную точку или расширение поля:


  • для вызовов версии 10.0 и более ранних, если владелец медиафайла скрыл количество отметок "Нравится", возвращается значение 0;
  • для вызовов версии 11.0 и более поздних, если владелец медиафайла скрыл количество отметок "Нравится", поле like_count исключается.

media_product_type
Общедоступное

Место публикации медиафайла. Возможные значения: AD, FEED, STORY или REELS.

media_type
Общедоступное

Тип медиафайла. Возможные значения: CAROUSEL_ALBUM, IMAGE и VIDEO.

media_url
Общедоступное

URL медиафайла.

Если медиафайл содержит материалы, защищенные авторским правом, или был помечен как нарушающий авторские права, поля media_url в ответе не будет. Пример материала, защищенного авторскими правами, — аудио в видео Reels.

owner
Общедоступное

ID пользователя Instagram, создавшего медиафайл. Возвращается, только если этот медиафайл создал пользователь приложения, выполняющий запрос; в противном случае возвращается поле username.

permalink
Общедоступное

Постоянный URL медиафайла.

shortcode
Общедоступное

Короткий код медиафайла.

thumbnail_url
Общедоступное

URL миниатюры медиафайла. Доступно только для медиафайлов типа VIDEO.

timestamp
Общедоступное

Дата создания в формате ISO 8601 в часовом поясе UTC (по умолчанию используется UTC ±00:00).

username
Общедоступное

Имя пользователя, создавшего медиафайл.

video_title
Общедоступное

Больше не используется. Отсутствует в ответе.

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

Общедоступные границы контекста можно получить через расширение поля.

Граница контекстаОписание

children
Общедоступное

Представляет подборку объектов IG Media для альбома IG Media.

collaborators

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

comments

Представляет подборку комментариев IG Comment к объекту IG Media.

insights

Представляет метрики социального взаимодействия для объекта IG Media.

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

Запрос

curl -X GET \
  'https://graph.facebook.com/v19.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

Ответ

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Обновление

POST /{ig-media-id}

Включает или отключает комментарии к объекту IG Media.

Ограничения

Видео в прямом эфире IG Media не поддерживаются.

Требования

ТипОписание

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

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

Разрешения

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management;
business_management.

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

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

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

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

{api-version}

Версия API.

{ig-media-id}

Обязательный параметр. ID объекта IG Media.

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

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

access_token

{access-token}

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

comment_enabled

{comment-enabled}

Обязательный параметр. Установите значение true, чтобы включить комментарии, или false, чтобы отключить.

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

Запрос

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Ответ

{
  "success": true
}

Удаление

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