Здесь перечислены изменения в Graph API для Instagram.
Applies to v18.0+. Will apply to all versions on December 11, 2023.
Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
AUDIENCE_GENDER_AGE
AUDIENCE_LOCALE
AUDIENCE_COUNTRY
AUDIENCE_CITY
GET /{ig-media-id}/insights
CAROUSEL_ALBUM_IMPRESSIONS
CAROUSEL_ALBUM_REACH
CAROUSEL_ALBUM_ENGAGEMENT
CAROUSEL_ALBUM_SAVED
CAROUSEL_ALBUM_VIDEO_VIEWS
TAPS_FORWARD
TAPS_BACK
EXITS
ENGAGEMENT
Note: total_interactions
, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement
metric.total_interactions
, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement
metric.
Относится ко всем версиям.
Если кто-либо прокомментировал продвигаемую или рекламную публикацию Instagram, в объекте media
поля comments
объекта value
будут возвращаться ad_id
и ad_title
.
Относится ко всем версиям.
Product Tagging API для Instagram теперь поддерживает видео Reels. В видео такого формата можно отмечать до 30 товаров.
Относится ко всем версиям.
Теперь видео Reels поддерживаются. Чтобы опубликовать ролик как видео Reels, установите для параметра media_type
значение REELS
при создании контейнера публикации с одним медиаобъектом. Обратитесь к справке по POST /ig-user/media endpoint
, чтобы узнать, какие параметры можно использовать с видео Reels, а также такие требования предусмотрены для таких видео.
Относится ко всем версиям.
Документация для разработчиков по устаревшему API для Instagram удалена. Теперь ссылки на нее перенаправляют пользователей на документацию для разработчиков по платформе Instagram.
Относится ко всем версиям.
Теперь вы можете создавать метки товаров Instagram Shopping для опубликованных медиафайлов Instagram Business и управлять этими метками. Подробнее см. в руководстве по работе с метками товаров.
Относится ко всем версиям.
Для партнеров в бета-версии Добавление меток товаров все варианты товаров, отвечающие критериям поиска, теперь будут возвращаться при поиске товаров в каталоге.
Относится ко всем версиям.
Теперь Instagram API можно использовать для размещения публикаций с несколькими изображениями и видео (публикации с кольцевыми галереями). Информацию обо всех этапах публикации см. в руководстве по публикации контента.
Если приложение уже прошло проверку и получило разрешения для публикации контента, для использования этой функции не требуется повторная проверка приложения.
Относится ко всем версиям.
Теперь вы можете использовать API Instagram, чтобы получать объекты видео в прямом эфире IG Media, транслируемые пользователями вашего приложения, получать комментарии к этим видео и использовать API обмена сообщениями в Instagram для отправки ответов авторам комментариев в личных сообщениях (сообщениях в Direct). Для поддержки этих возможностей были внесены следующие изменения:
media
объекта IG Comment теперь возвращает объект, содержащий ID (id
) и место публикации (media_product_type
) медиа, к которому добавлен комментарий;live_comments
Instagram Webhooks может отправлять уведомления, которые содержат комментарии, добавленные к видео в прямом эфире пользователями приложения во время трансляции.Подробнее о том, как отправлять ответы в личных сообщениях пользователям, прокомментировавшим объекты видео в прямом эфире IG Media, см. в документации по ответам в личных сообщениях в разделе API обмена сообщениями в Instagram.
Относится ко всем версиям.
Для комментариев IG Comment добавлены два новых поля:
parent_id
— возвращает ID родительского комментария IG Comment, если комментарий был создан в качестве ответа на существующий комментарий.Относится ко всем версиям.
Полеcomments
в Webhooks Instagram теперь содержит следующие свойства в объекте поля value
:
from.id
— IGSID пользователя Instagram, который создал комментарий;from.username
— имя пользователя Instagram, который создал комментарий;media.id
— ID объекта IG Media, к которому добавлен комментарий;media.media_product_type
— место публикации объекта IG Media, к которому добавлен комментарий;parent_id
— ID родительского комментария IG Comment, если комментарий был создан в качестве ответа на существующий комментарий.Эти изменения относятся к видео IGTV, созданным начиная с 5 октября 2021 г. Они не распространяются на видео IGTV, созданные до этой даты.
video_title
не возвращается.3 января 2022 г. перечисленные выше изменения будут применены ко всем версиям API и всем видео IGTV независимо от даты создания. Это означает, что начиная с 3 января 2022 г. приложения, использующие более старые версии API, смогут запрашивать видео IGTV (поддержка чтения была добавлена в версии 10.0 и ограничена версией 10.0 и более поздними).
Начиная с версии 14.0 поле video_title
не поддерживается, и при его запросе API будет выдавать ошибку.
Относится к версии 11.0 и более поздним. Начнет действовать для всех версий с 7 сентября 2021 г.
При непрямом запросе объекта IG Media через другую конечную точку или расширение поля в ответе на вызов API будет отсутствовать поле like_count
, если владелец медиаобъекта скрыл количество поставленных ему отметок "Нравится". При прямом запросе объекта IG Media (который может выполнить только его владелец) возвращается реальное количество отметок "Нравится", даже если этот показатель был скрыт.
Относится к версии 11.0 и более поздним.
Для конечной точки GET /{ig-user-id}/media
добавлены параметры since
и until
для поддержки разбивки на страницы по времени.
При непрямом запросе объекта IG Media через другую конечную точку для поля like_count теперь будет возвращаться значение 0
, если пользователь приложения не является владельцем медиаобъекта, а владелец скрыл для него количество отметок "Нравится". При прямом запросе объекта IG Media (который может совершить только владелец) возвращается реальное количество отметок "Нравится", даже если владелец скрыл его для данного объекта.
Внесено небольшое изменение в механизм расчета метрики online_followers
для IG User.
Взаимодействие пользователей из Японии с объектами IG Media историй больше не учитываются при некоторых расчетах метрики replies
:
replies
для историй, созданных пользователями из Японии, будет возвращать значение 0
;replies
для историй, созданных пользователями из других регионов, будет возвращать количество ответов, но ответы пользователей из Японии учитываться не будут.Исправлена ошибка с метриками охвата для историй IG Media.
status
контейнера IG Container теперь возвращает подкод ошибки, если значение поля error_code
контейнера — ERROR
.video_views
IG Media Insights теперь поддерживает альбомы и возвращает вместо 0
сумму video_views
для всех видео в альбоме.Медиафайлы IGTV поддерживаются начиная с версии 10.0. IGTV поддерживают все конечные точки, кроме точек для публикации контента и Webhooks. Для узла IG Media добавлены поля media_product_type
и video_title
. Чтобы доступ к медиафайлам IGTV можно было получить через API, они должны быть отправлены в Instagram во время публикации (задан параметр Опубликовать предпросмотр или Поделиться предпросмотром в ленте).
Период бета-тестирования функций публикации контента завершен. Публиковать медиафайлы в профессиональных аккаунтах Instagram теперь могут все разработчики. Подробные сведения об использовании см. в руководстве по публикации контента.
В соответствии с требованиями принятой в ЕС директивы о конфиденциальности и электронных средствах связи, с 1 декабря 2020 г. взаимодействия пользователей из Европейской экономической зоны (ЕЭЗ) с объектами IG Media историй, связанные с отправкой сообщений, больше не будут учитываться при расчете некоторых метрик:
replies
для историй, созданных пользователями из ЕЭЗ, будет возвращать значение 0
;replies
для историй, созданных пользователями из других регионов, будет возвращать количество ответов, но ответы пользователей из ЕЭЗ не будут учитываться.Это изменение относится ко всем версиям.
follower_count
объектов IG User приведены в соответствие со значениями, отображаемыми в приложении Instagram. Кроме того, follower_count
теперь возвращает данные максимум за 30 дней, а не за 2 года. Для всех прочих версий это изменение вступит в силу 9 мая 2021 г.timestamp
объекта IG Media, возвращаемого запросами поиска по хэштегамGET /{ig-hashtag-id}/top_media
и GET /{ig-hashtag-id}/recent_media
. Пример: GET /{ig-hashtag-id}/top_media?fields=timestamp
.story_insights
вместо разрешения instagram_manage_comments
теперь необходимо разрешение instagram_manage_insights
.#spooky
!/{ig-media-id}/comments
: для запросов GET
с использованием API версии 3.1 и более ранних результаты будут возвращаться в хронологическом порядке. Запросы с использованием версии 3.2 и более поздних возвращают результаты в обратном хронологическом порядке. /{ig-media-id}
: теперь поле permalink
для медиаобъектов можно получать с помощью расширения поля./{ig-comment-id}
username
.GET
поле user
отсутствует в ответе, если пользователь, выполняющий такой запрос, не является владельцем комментария. Вместо этого для всех комментаторов возвращается username
. Это также относится к запросам комментариев через другие API, например Mentions API./{ig-media-id}
username
.GET
поле owner
отсутствует в ответе, если пользователь, выполняющий такой запрос, не является владельцем медиаобъекта. Вместо этого для всех комментаторов возвращается username
. Это также относится к запросам медиаобъектов через другие API, например Mentions API.Insights API: статистика теперь будет содержать действия с рекламой, генерируемые через API, интерфейсы рекламы Facebook и функцию продвижения Instagram. Это повлияет на следующие метрики:
impressions
;reach
./{ig-user-id}/media
.timestamp
узла /{ig-media-id}
теперь является общедоступным и может возвращаться через расширение поля./{ig-user-id}
, /{ig-comment-id}
и /{ig-media-id}
при доступе к ним через границу контекста и расширение поля теперь возвращают все общедоступные поля. Сведения о том, какие поля являются общедоступными, можно найти в справочной документации по этим узлам./{ig-user-id}/media
могут добавлять хэштеги. #crazywildebeest
!