IG Media

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

Поле:

• legacy_instagram_media_id

Следующие поля конечной точки Instagram Ads Marketing API не поддерживаются:

• filter_name
• location
• location_name
• latitude
• longitude

Создание

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

Чтение

GET /<IG_MEDIA_ID>

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

Требования

Ограничения

• Такие поля, как comments_count и like_count, возвращают данные о вовлеченности только для целевого медиафайла Instagram и не включают в себя данные из других источников. Например, в поле comments_count возвращается количество комментариев к фото, но не количество комментариев к содержащим его рекламным объявлениям. Используйте total_comments_count и total_like_count, чтобы получить обобщенные показатели, которые включают вовлеченность из продвигаемых/использующихся в рекламе медиафайлов. Может включать данные кросс-публикации на Facebook, если она доступна пользователю сеанса.
• Подписи не будут включать символ @, если у пользователя в приложении нет разрешений для выполнения задач, аналогичных задачам администратора.
• Некоторые поля, например permalink, нельзя использовать для фото в альбомах (дочерних объектов).
• Объект Instagram Media видео в прямом эфире можно прочитать только во время трансляции.
• Этот API возвращает только данные медиафайлов, принадлежащих профессиональным аккаунтам Instagram. Его нельзя использовать для получения данных медиафайлов, принадлежащих личным аккаунтам Instagram.
• Поля reposts_count, saved_count, shares_count, total_like_count, total_comments_count и total_views_count недоступны для дочерних медиафайлов кольцевой галереи и возвращаются только для медиаобъектов верхнего уровня. Владелец медиаобъекта может отключить показ отметок "Нравится", комментариев, просмотров, репостов и публикаций. В этом случае соответствующие поля не возвращаются.

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

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

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

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

Поля

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

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

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

Пример cURL

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

curl -X GET \
  'https://graph.instagram.com/v26.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>

Включает или отключает комментарии к Instagram Media.

Ограничения

Прямые эфиры Instagram Media не поддерживаются.

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

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

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

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

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

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

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

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

{
  "success": true
}

Удаление

DELETE /<IG_MEDIA_ID>

Удаление медиафайлов Instagram.

Требования

Ограничения

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

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

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

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

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

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

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

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

Пример ответа (Успешно):

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Пример ответа (Ошибка, Тип медиафайла не поддерживается):

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}