Платформа Instagram

Журнал изменений для платформы Instagram

В этом журнале изменений описаны изменения в Instagram API.

Связанные журналы изменений

3 октября 2024 г.

Flows приветственных сообщений теперь доступны для Instagram API с входом через Instagram. Подробнее…

2 октября 2024 г.

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

17 сентября 2024 г.

Новые значения scope

Относится ко всем версиям.

Чтобы обеспечить единообразие между значениями scope и именами разрешений, мы представляем новые значения scope для Instagram API с входом через Instagram. Новые значения scope:

  • instagram_business_basic;
  • instagram_business_content_publish;
  • instagram_business_manage_comments;
  • instagram_business_manage_messages.

Они заменят существующие значения business_basic, business_content_publish, business_manage_comments и business_manage_messages соответственно.

Обратите внимание, что старые значения scope будут упразднены 27 января 2025 г. Обновите код до этой даты, чтобы избежать сбоев в работе приложения. В противном случае ваше приложение не сможет отправлять вызовы к конечным точкам Instagram.

Уточнение: дата упразднения перенесена с 17 декабря 2024 г. на 25 января 2025 г.

23 июля 2024 г.

Запуск нового Instagram API с входом через Instagram

Компоненты этого нового Instagram API:

  • страница Facebook более не требуется;
  • URL хоста для вызовов API: graph.instagram.com;
  • новые разрешения для этого API:
    • instagram_business_basic;
    • instagram_business_content_publish;
    • instagram_business_manage_comments;
    • instagram_business_manage_messages.
  • Messenger API более не будет использоваться для отправки сообщений в Instagram;
  • для новых приложений Meta при создании будет добавляться новый продукт Instagram;
  • для уже существующих приложений можно добавлять новый продукт Instagram на панели приложений.

Чтобы узнать, подходит ли вам этот новый Instagram API с входом через Instagram, ознакомьтесь с нашим руководством по миграции.

11 июня 2024 г.

Webhooks комментариев Instagram

Относится ко всем версиям.

Если кто-либо прокомментировал продвигаемую или рекламную публикацию в Instagram, в дополнение к параметрам ad_id и ad_title будет возвращаться параметр original_media_id в объекте media объекта value поля comments. Подробнее см. в статье Настройка Webhooks для Instagram.

21 мая 2024 г.

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

12 сентября 2023 г.

Deprecation of Media and User Insights

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.

9 ноября 2022 г.

Instagram Webhooks

Относится ко всем версиям.

Если кто-либо прокомментировал продвигаемую или рекламную публикацию в Instagram, в объекте media объекта value поля comments будут возвращаться параметрыad_id и ad_title.

31 октября

Видео Reels: метки товаров

Относится ко всем версиям.

Product Tagging API для Instagram теперь поддерживает видео Reels В видео такого формата можно отмечать до 30 товаров.

28 июня 2022 г.

Видео Reels

Относится ко всем версиям.

Теперь видео Reels поддерживаются. Чтобы опубликовать ролик как видео Reels, установите для параметра media_type значение REELS при создании контейнера публикации с одним медиаобъектом. Обратитесь к справке по POST /ig-user/media endpoint, чтобы узнать, какие параметры можно использовать с видео Reels, а также такие требования предусмотрены для таких видео.

27 июня 2022 г.

Документация по устаревшему API для Instagram

Относится ко всем версиям.

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

20 июня 2022 г.

Добавление меток товаров

Относится ко всем версиям.

Теперь вы можете создавать метки товаров Instagram Shopping для опубликованных медиафайлов Instagram Business и управлять этими метками. Подробнее см. в руководстве по работе с метками товаров.

27 мая 2022 г.

Варианты товаров

Относится ко всем версиям.

Для партнеров в бета-версии Добавление меток товаров все варианты товаров, отвечающие критериям поиска, теперь будут возвращаться при поиске товаров в каталоге.

15 марта 2022 г.

Публикации с кольцевыми галереями

Относится ко всем версиям.

Теперь Instagram API можно использовать для размещения публикаций с несколькими изображениями и видео (публикации с кольцевыми галереями). Информацию обо всех этапах публикации см. в руководстве по публикации контента.

Если приложение уже прошло проверку и получило разрешения для публикации контента, для использования этой функции не требуется повторная проверка приложения.

9 ноября 2021 г.

Видео в прямом эфире

Относится ко всем версиям.

Теперь вы можете использовать API Instagram, чтобы получать объекты видео в прямом эфире IG Media, транслируемые пользователями вашего приложения, получать комментарии к этим видео и использовать API обмена сообщениями в Instagram для отправки ответов авторам комментариев в личных сообщениях (сообщениях в Direct). Для поддержки этих возможностей были внесены следующие изменения:

  • новая граница контекста GET /ig-user/live_media может возвращать объекты видео в прямом эфире IG Media, транслируемые пользователями приложения на момент запроса;
  • поле media объекта IG Comment теперь возвращает объект, содержащий ID (id) и место публикации (media_product_type) медиа, к которому добавлен комментарий;
  • новое поле live_comments Instagram Webhooks может отправлять уведомления, которые содержат комментарии, добавленные к видео в прямом эфире пользователями приложения во время трансляции.

Подробнее о том, как отправлять ответы в личных сообщениях пользователям, прокомментировавшим объекты видео в прямом эфире IG Media, см. в документации по ответам в личных сообщениях в разделе API обмена сообщениями в Instagram.

20 октября 2021 г.

Комментарии IG Comment

Относится ко всем версиям.

Для комментариев IG Comment добавлены два новых поля:

  • from — возвращает объект, содержащий IGSID (id) и имя пользователя (username) автора комментария;
  • parent_id — возвращает ID родительского комментария IG Comment, если комментарий был создан в качестве ответа на существующий комментарий.

Webhooks Instagram

Относится ко всем версиям.

Поле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, если комментарий был создан в качестве ответа на существующий комментарий.

5 октября 2021 г.

Эти изменения относятся к видео IGTV, созданным начиная с 5 октября 2021 г. Они не распространяются на видео IGTV, созданные до этой даты.

  • Полеmedia_product_type возвращает значение FEED, а не IGTV.
  • Полеvideo_title не возвращается.
  • Добавлена поддержка полей comments и mentions в Instagram Webhooks.

3 января 2022 г. перечисленные выше изменения будут применены ко всем версиям API и всем видео IGTV независимо от даты создания. Это означает, что начиная с 3 января 2022 г. приложения, использующие более старые версии API, смогут запрашивать видео IGTV (поддержка чтения была добавлена в версии 10.0 и ограничена версией 10.0 и более поздними).

Начиная с версии 14.0 поле video_title не поддерживается, и при его запросе API будет выдавать ошибку.

8 июня 2021 г.

Количество отметок "Нравится"

Относится к версии 11.0 и более поздним. Начнет действовать для всех версий с 7 сентября 2021 г.

При непрямом запросе объекта IG Media через другую конечную точку или расширение поля в ответе на вызов API будет отсутствовать поле like_count, если владелец медиаобъекта скрыл количество поставленных ему отметок "Нравится". При прямом запросе объекта IG Media (который может выполнить только его владелец) возвращается реальное количество отметок "Нравится", даже если этот показатель был скрыт.


Разбивка на страницы по времени

Относится к версии 11.0 и более поздним.

Для конечной точки GET /{ig-user-id}/media добавлены параметры since и until для поддержки разбивки на страницы по времени.

26 мая 2021 г.

При непрямом запросе объекта IG Media через другую конечную точку для поля like_count теперь будет возвращаться значение 0, если пользователь приложения не является владельцем медиаобъекта, а владелец скрыл для него количество отметок "Нравится". При прямом запросе объекта IG Media (который может совершить только владелец) возвращается реальное количество отметок "Нравится", даже если владелец скрыл его для данного объекта.

4 мая 2021 г.

Внесено небольшое изменение в механизм расчета метрики online_followers для IG User.

14 апреля 2021 г.

Взаимодействие пользователей из Японии с объектами IG Media историй больше не учитываются при некоторых расчетах метрики replies:

  • метрика replies для историй, созданных пользователями из Японии, будет возвращать значение 0;
  • метрика replies для историй, созданных пользователями из других регионов, будет возвращать количество ответов, но ответы пользователей из Японии учитываться не будут.

12 апреля 2021 г.

Исправлена ошибка с метриками охвата для историй IG Media.

9 апреля 2021 г.

  • Поле status контейнера IG Container теперь возвращает подкод ошибки, если значение поля error_code контейнера — ERROR.
  • Метрика video_viewsIG Media Insights теперь поддерживает альбомы и возвращает вместо 0 сумму video_views для всех видео в альбоме.

16 марта 2021 г.

Медиафайлы IGTV поддерживаются начиная с версии 10.0. IGTV поддерживают все конечные точки, кроме точек для публикации контента и Webhooks. Для узла IG Media добавлены поля media_product_type и video_title. Чтобы доступ к медиафайлам IGTV можно было получить через API, они должны быть отправлены в Instagram во время публикации (задан параметр Опубликовать предпросмотр или Поделиться предпросмотром в ленте).

26 января 2021 г.

Период бета-тестирования функций публикации контента завершен. Публиковать медиафайлы в профессиональных аккаунтах Instagram теперь могут все разработчики. Подробные сведения об использовании см. в руководстве по публикации контента.

2 декабря 2020 г.

В соответствии с требованиями принятой в ЕС директивы о конфиденциальности и электронных средствах связи, с 1 декабря 2020 г. взаимодействия пользователей из Европейской экономической зоны (ЕЭЗ) с объектами IG Media историй, связанные с отправкой сообщений, больше не будут учитываться при расчете некоторых метрик:

  • метрика replies для историй, созданных пользователями из ЕЭЗ, будет возвращать значение 0;
  • метрика replies для историй, созданных пользователями из других регионов, будет возвращать количество ответов, но ответы пользователей из ЕЭЗ не будут учитываться.

Это изменение относится ко всем версиям.

10 ноября 2020 г.

  • Статистика пользователей Instagram: значения follower_count объектов IG User приведены в соответствие со значениями, отображаемыми в приложении Instagram. Кроме того, follower_count теперь возвращает данные максимум за 30 дней, а не за 2 года. Для всех прочих версий это изменение вступит в силу 9 мая 2021 г.

5 мая 2020 г.

3 декабря 2019 г.

  • Статистика: чтобы привести работу API в соответствие с работой приложения Instagram, статистика по пользователям IG теперь доступна только для пользователей с количеством подписчиков не менее 100.

13 августа 2019 г.

  • Business Discovery: API Business Discovery теперь можно использовать для получения данных о других аккаунтах авторов Instagram.

22 мая 2019 г.

9 мая 2019 г.

  • Webhook: для поля story_insights вместо разрешения instagram_manage_comments теперь необходимо разрешение instagram_manage_insights.

31 октября 2018 г.

  • Hashtag Search API: теперь вы можете искать медиафайлы, отмеченные специальными хэштегами, с помощью нашего нового Hashtag Search API. #spooky!

23 октября 2018 г.

  • Граница контекста /{ig-media-id}/comments: для запросов GET с использованием API версии 3.1 и более ранних результаты будут возвращаться в хронологическом порядке. Запросы с использованием версии 3.2 и более поздних возвращают результаты в обратном хронологическом порядке.

7 июня 2018 г.

  • Узел /{ig-media-id}: теперь поле permalink для медиаобъектов можно получать с помощью расширения поля.

1 мая 2018 г.

  • Подтверждение компании: чтобы приложение могло использовать Graph API для Instagram, ваша компания должна быть подтверждена. Это часть процесса проверки приложений и необходимое условие для всех конечных точек Graph API для Instagram. Приложения, прошедшие проверку до 1 мая 2018 г., должны пройти ее повторно до 1 августа 2018 г. В противном случае они утратят доступ к этому API.

24 апреля 2018 г.

  • Узел /{ig-comment-id}
    • Добавлено новое поле username.
    • Для запросов GET поле user не включается в ответы, если пользователь, выполняющий такой запрос, не является владельцем комментария. Вместо этого для всех комментаторов возвращается username. Это также относится к запросам комментариев через другие API, например Mentions API.
  • Узел /{ig-media-id}
    • Добавлено новое поле username.
    • Для запросов GET поле owner не включается в ответы, если пользователь, выполняющий такой запрос, не является владельцем медиаобъекта. Вместо этого для всех комментаторов возвращается username. Это также относится к запросам медиаобъектов через другие API, например Mentions API.

23 апреля 2018 г.

  • API Insights: статистика теперь будет включать действия с рекламой, генерируемые через API, интерфейсы рекламы Facebook и функцию продвижения Instagram. Это повлияет на следующие метрики:

    • impressions;
    • reach.

13 марта 2018 г.

  • Content Publishing API: партнеры по бета-тестированию при публикации фотографий теперь могут отмечать места и общедоступные профили пользователей Instagram с помощью границы контекста /{ig-user-id}/media.

8 марта 2018 г.

  • Общедоступные поля: поле timestamp узла /{ig-media-id} теперь является общедоступным и может возвращаться через расширение поля.

22 февраля 2018 г.

  • Общедоступные поля: узлы /{ig-user-id}, /{ig-comment-id} и /{ig-media-id} при доступе к ним через границу контекста и расширение поля теперь возвращают все общедоступные поля. Сведения о том, какие поля являются общедоступными, можно найти в справочной документации по этим узлам.

8 февраля 2018 г.

  • Content Publishing API: теперь партнеры по бета-тестированию при публикации фотографий через границу контекста /{ig-user-id}/media могут добавлять хэштеги. #crazywildebeest!