Платформа Instagram
Сменить язык обратно на Русский
Этот документ обновлен.
Перевод (Русский) еще не готов.
Последнее обновление (английский): 1 сен

IG Media

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

С 3 июня 2024 г. можно использовать поле boost_eligibility_info, которое предлагает удобный и эффективный способ определить, можно ли продвигать медиафайл в качестве рекламы, а также поле boost_ads_list для отслеживания связанной с этой рекламой информацией о прошлых продвижениях объявления в Instagram. Подробнее см. в блоге. Только для Instagram Graph API.

Создание

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

Чтение

GET /<IG_MEDIA_ID>

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

Ограничения

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

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

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

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

<API_VERSION>

Версия API.

<IG_MEDIA_ID>

Обязательный параметр. ID публикуемого медиафайла.

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

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

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_FIELDS>

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

Поля

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

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

boost_ads_list

Содержит обзор всей информации о рекламе в Instagram, связанной с органическим медиафайлом. Включает в себя относительный ID объявления и статус показа рекламы. Только для Instagram Graph API.

boost_eligibility_info

Это поле предоставляет информацию о возможностях продвижения медиафайла в Instagram в качестве рекламы и дополнительные сведения, если продвижение невозможно, потому что файл не соответствует требованиям. Только для Instagram Graph API.

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

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

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 медиафайла.

is_comment_enabled

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

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

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

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

like_count

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


Если выполняется косвенный запрос через другую конечную точку или расширение поля и владелец медиафайла скрыл количество отметок "Нравится", поле like_count опускается.

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

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

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
Общедоступное

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

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

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

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

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

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

collaborators

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

comments

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

insights

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

Пример cURL

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

curl -X GET \
  'https://graph.instagram.com/v21.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 в прямом эфире не поддерживаются.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram 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_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

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
  • business_management

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

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

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

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

<API_VERSION>

Версия API.

<IG_MEDIA_ID>

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

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

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

access_token

<ACCESS_TOKEN>

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

comment_enabled

<BOOL>

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

Пример cURL

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

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

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

{
  "success": true
}

Удаление

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