Graph API

Версия 7.0

API Graph

Выпуск: 5 мая 2020 г. | Доступно до: 4 августа 2022 г. | Запись в блоге

Расширение Facebook Business, версия 2

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

В расширение Facebook Business версии 2 добавлено два новых поля.

  • ID рекламного аккаунта (ad_account_id) — ID, выбранный пользователем в FBE. Если у вашего приложения есть разрешение ads_management, с помощью рекламного аккаунта можно управлять рекламой.

  • ID каталога (catalog_id) — ID каталога, выбранный пользователем в FBE. С его помощью можно управлять каталогом продуктов.

Instagram

Поиск по хэштегам

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

Теперь можно запросить поле timestamp объекта IG Media, возвращаемого запросами поиска по хэштегамGET /{ig-hashtag-id}/top_media и GET /{ig-hashtag-id}/recent_media. Пример: GET /{ig-hashtag-id}/top_media?fields=timestamp.

Messenger

Плагин чата с клиентами

Это изменение относится к версии 7.0 и более поздним. Со 2 ноября 2020 г. оно будет распространяться на все версии.

Когда вы начинаете новую переписку или продолжаете существующую с помощью плагина чата с клиентами, начальные уведомления Webhooks messaging_postbacks и messaging_referrals будут содержать анонимный ID пользователя user_ref, а не пользовательский ID внутри страницы (PSID). Когда пользователь отправит сообщение, последующие уведомления Webhook будут содержать PSID пользователя.

Профили Messenger Страницы

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

Свойство home_url в профиле Messenger Страницы упразднено для всех операций (GET, POST и DELETE).

Open Graph

Упразднения

Это изменение относится к версии 7.0 и более поздним. С 3 августа 2020 г. оно будет распространяться на все версии.

Страницы

ID пользователей внутри приложения

Эти изменения относятся к версии 7.0 и более поздним. С 5 мая 2021 г. они будут распространяться на все версии.

С 1 мая 2018 г. для всех новых приложений API Pages возвращает ID пользователей внутри Страницы (PSID) вместо ID пользователей внутри приложения (ASID). Приложения, созданные до этой даты, будут по-прежнему получать ASID, если не дадут согласие получать PSID. Все приложения будут получать PSID через API Pages.

С помощью API Page-Scoped ID можно сопоставлять ASID с соответствующими PSID. Этот API упраздняется начиная с версии 7.0, но его можно будет использовать с более старыми версиями до 5 мая 2021 г.

Упразднения

Эти изменения относятся к версии 7.0 и более поздним. С 3 августа 2020 г. они будут распространяться на все версии.

Будут упразднены следующие конечные точки:

Разрешения

Разрешение manage_pages упразднено и заменено 4 новыми разрешениями:

Разрешение publish_pages упразднено и заменено 2 новыми разрешениями:

Приложения, у которых уже есть разрешения manage_pages или publish_pages либо оба, будут переведены на новые разрешения до 1 июня 2020 г.

Для приложений, которые отправили запрос на получение разрешений manage_pages или publish_pages либо обоих, но ещё не были проверены, процесс проверки продолжится в обычном режиме. После утверждения приложения будут переведены на новые разрешения до 1 июня 2020 г.

Чтобы подать заявку на разрешения для Страницы впервые или повторно до 1 июня 2020 г., выберите разрешения на панели приложения: manage_pages, publish_pages, оба или новые разрешения. Если это необходимо, ваше приложение будет автоматически переведено на новые разрешения до 1 июня 2020 г.

После 1 июня 2020 г. разрешения manage_pages и publish_pages станут доступны в разделе Проверка приложения > Разрешения и функции на панели приложения.

Разрешения manage_pages и publish_pages будут полностью упразднены в мае 2022 г. Изменения в коде необходимо сделать до этого времени.

SDK

Важные сведения о предстоящих изменениях в соответствующих SDK см. в журналах изменений в SDK для iOS и Android.

Пользователь

Упразднения

Эти изменения относятся к версии 7.0 и более поздним. С 3 августа 2020 г. они будут распространяться на все версии.

Будут упразднены следующие конечные точки:

API Marketing

Выпуск: 5 мая 2020 г. | Доступно до: 3 марта 2021 г. | Запись в блоге

Рекламные кампании

Оптимизация бюджета кампании

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

Вы больше не можете указывать для рекламной кампании одновременно lifetime_budget и spend_cap. Можно выбрать только lifetime_budget.

Бюджет распределяется на весь срок действия кампании. Если вы используете lifetime_budget на уровне кампании, в него входит информация о пределе затрат. Поэтому указывать его дополнительно не требуется.

Вы можете по-прежнему использовать spend_cap для кампаний, в которых не предусмотрена оптимизация бюджета кампании.

Особая категория рекламы

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

Параметр special_ad_category конечной точки POST /act_<AD_ACCOUNT_ID>/campaigns упразднен и заменен параметром special_ad_categories.

Новый параметр special_ad_categories является обязательным и в качестве данных принимает массив. Если вы получаете параметр special_ad_category, он по-прежнему будет возвращать строку. Чтобы получить массив, необходимо использовать GET /{campaign-id}?fields=special_ad_categories.

Подробнее см. в статье об особых категориях рекламы.

Подробнее об особых категориях рекламы см. в Справочном центре по рекламе.

Упразднения

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

Параметр budget_rebalance_flag упразднен. Мы рекомендуем использовать вместо него оптимизацию бюджета кампании.

Рекламные кампании Atlas

Упразднения

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

  • GET /{atlas-ad-campaign-id}/cumulative_edited_date

Каталог товаров

Упразднения

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

Параметр cpas_parent_catalog_settings границы контекста POST /PRODUCT_CATALOG_ID для сторонних приложений упразднен.