Introducing Facebook Graph API v12.0 and Marketing API v12.0

14 сентября 2021 г.Автор:Mengjiao Zhu

Подписаться на блог "Новости для разработчиков"

Сегодня мы выпускаем Facebook API Graph 12.0 и API Marketing 12.0. Ниже мы выделили изменения, которые коснутся части нашего сообщества разработчиков. Эти изменения включают в себя оповещения и обновления продуктов, напоминания о предыдущих запусках и уведомления о широкомасштабных упразднениях, которые могут повлиять на интеграцию ваших приложений с нашей платформой.

Полный список всех изменений и сведения о них см. в журнале изменений.

Общие оповещения и обновления

API Conversions: расширение минимальной вызываемой версии

Обратная совместимость API Graph для приложений, созданных с маркерами доступа одним щелчком. Начиная с версии 12.0 маркеры доступа, созданные на вкладке настроек API Conversions в Events Manager, теперь поддерживаются всеми доступными версиями API Graph (см. список поддерживаемых версий).

Обратите внимание: вызовы, выполняемые с этими маркерами к устаревшей версии API Graph, автоматически разрешаются до самой старой доступной версии. Это действует только для конечных точек API Graph. Конечные точки API Marketing, включая API Conversions, не поддерживают автоматическое обновление и вызывают исключение.

API User Profile для обмена сообщениями в Instagram: новые поля

Мы совершенствуем API User Profile для обмена сообщениями в Instagram. Ранее интерфейс API User Profile для Instagram поддерживал два поля: имя и URL-адрес фото профиля. Чтобы компании могли лучше персонализировать сообщения и назначать им приоритет на основании общедоступной информации о пользователях, мы обновили API, добавив в него следующие сведения:

1. Количество подписчиков.
2. Значок подтверждения.
3. Подписана ли компания на аккаунт пользователя [да/нет].
4. Подписан ли пользователь на аккаунт компании [да/нет].

Дополнительные сведения см. в документации для разработчиков.

Новые возможности детального таргетинга

Чтобы рекламодатели могли найти дополнительные возможности, которые были им изначально недоступны, при использовании детального таргетинга и оптимизации для конверсий, ценности или событий в приложении с использованием цели "Конверсии" они будут автоматически добавляться в расширение таргетинга. Дополнительные сведения см. в статье Справочного центра О расширении таргетинга.

API Video: новые поля

Для узла [Video] добавлено два новых поля: views и post_views. Дополнительные сведения см. в документации по API Video для разработчиков.

Упраздненные элементы и важные изменения

Прозрачность ошибок

По умолчанию API Graph и API Marketing выдают ошибку, когда приложение запрашивает поле или границу контекста для узла, который возвращает один или несколько связанных узлов, но не имеет необходимых для них разрешений. Однако некоторые из этих полей и границ контекста не соответствовали этому протоколу и вместо этого просто опускались в ответах API, если вызывающему приложению не хватало соответствующих разрешений.

Начиная с версии 12.0 эти поля и границы контекста будут действовать по умолчанию. Для всех версий это изменение вступит в силу 13 декабря 2021 г.

Системные пользователи и роли в приложениях

Мы упраздняем возможность предоставления системным пользователям ролей в приложениях, если пользователи и приложения не принадлежат одной и той же компании. Чтобы предотвратить нарушение работы вашего приложения и бизнеса, рекомендуем удалить этих системных пользователей из приложения и использовать вместо них API Business On Behalf Of. Это важное изменение вступит в силу 13 декабря 2021 г.

Запланированный прямой эфир

Мы упраздняем параметр planned_start_time для возможности планирования в Live API. Это важное изменение вступит в силу 13 декабря 2021 г. Новый параметр будет объявлен позже.

Платформа Messenger: API Conversation

Мы упраздняем поле user_id из метаданных переписки в API Conversation. Разработчикам нужно будет перенести все ссылки на user_id (IGID) и использовать IGSID как основной идентификатор переписки между пользователем и компанией.

Это важное изменение вступит в силу для более ранних версий API Graph 13 декабря 2021 г. Дополнительные сведения см. в документации по API Conversation для разработчиков.

Платформа Messenger: веб-перехватчики (Webhooks) для Instagram

Мы обновляем веб-перехватчик реакций в API Messenger для Instagram, чтобы обеспечить лучшую поддержку реакций со смайликами. Текущая версия возвращает поле смайлика в виде строки. После обновления веб-перехватчики реакций будут возвращать его в новом формате Юникода. Обратите внимание: поле reaction поддерживает только смайлики, используемые по умолчанию. Для всех остальных смайликов поле reaction будет возвращать значение other, так же как и MSGR.

Это важное изменение вступит в силу для более ранних версий API Graph с 13 декабря 2021 г. Чтобы и дальше поддерживать реакции со смайликами, всем разработчикам необходимо перейти на новый формат Юникода, который мы возвращаем к 13 декабря 2021 г. Дополнительные сведения см. в документации по Webhooks для разработчиков.

Упраздненные версии API

Обратите внимание на следующие упразднения в рамках графика управления версиями API Graph и API Marketing для Facebook.

API Graph

2 ноября 2021 г. будет упразднена и удалена с платформы версия API Graph 4.0.
3 февраля 2022 г. будет упразднена и удалена с платформы версия API Graph 5.0.
22 мая 2022 г. будет упразднена и удалена с платформы версия API Graph 6.0.

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

API Marketing

Версия API Marketing 10.0 будет упразднена 4.10.2021.
Версия API Marketing 11.0 будет упразднена 23.02.2022.

Чтобы избежать перебоев в работе, рекомендуем перенести все вызовы на новую версию API Marketing, которая была запущена сегодня. Дополнительные сведения см. в журнале изменений.

SDK Платформы Facebook

19 января 2021 г. мы представили двухлетний график упразднения SDK Платформы Facebook версии 8.x и более ранних. Поддержка этих версий закончится в январе 2023 г.
8 июня 2021 г. мы выпустили SDK Платформы Facebook 11.0, что стало началом упразднения SDK Платформы Facebook 9.0, рассчитанного на два года. Поддержка SDK 9.0 закончится в январе 2023 г.