Версия 9.0

API Graph

Выпуск: 10 ноября 2020 г. | Доступно до: 23 февраля 2023 г. | Запись в блоге

Группы

Упраздненные конечные точки

Упразднены в версии 9.0 и более поздних. Будут упразднены во всех версиях с 9 февраля 2021 г.

• GET /{group-id}?fields=owner

Instagram

Объявления

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

ID объектов IG Media и IG User теперь можно использовать с API Instagram Ads для создания объявлений. Подробнее см. в журнале изменений API Instagram Ads.

Статистика

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

Значения follower_count объектов IG User приведены в соответствие со значениями, отображаемыми в приложении Instagram. Кроме того, follower_count теперь возвращает данные максимум за 30 дней, а не за 2 года.

API Marketing

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

Правила кастомизации креативов

Упраздненные конечные точки

Упразднены в версии 9.0 и более поздних.

• GET /{asset_customization_rule_id}/

Примечание. Вы по-прежнему можете запрашивать отдельные правила кастомизации креативов, используя поле asset_feed_spec узла рекламного креатива.

Ставки

Упразднена стратегия назначения ставок

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

Стратегия назначения ставокtarget_cost упразднена. Начиная с версии 9.0 больше нельзя создавать или обновлять группы объявлений или рекламные кампании с этой настройкой. Вместо этого мы рекомендуем использовать стратегию предельной цены.

Упразднен вариант биллинга и оптимизации

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

Начиная с версии 9.0 биллинг рекламы приложений по принципу CPA упразднен. Теперь APP_INSTALLS нельзя выбрать одновременно и в качестве события биллинга, и в качестве цели оптимизации. Для событий биллинга мы рекомендуем выбирать impression.

Вы по-прежнему можете задавать APP_INSTALLS в качестве billing_event или optimization_goal, но не одновременно.

Бизнес-приложения

Ограничения доступа к конечным точкам

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

Доступ к следующим конечным точкам временно есть только у приложений, которые запрашивали их в течение последних 90 дней:

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

API Catalog

Группы товаров

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

По умолчанию конечная точка DELETE /{product_set_id} больше не удаляет группы товаров, если они используются в активной рекламе, подборках магазинов или для других целей. Чтобы изменить это, добавьте в запрос новый параметр allow_live_product_set_deletion=true.

API Instagram Ads

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

Начиная с версии 9.0 с помощью API Marketing можно создавать рекламу в Instagram на основе существующих публикаций. См. статью Использование публикаций в качестве рекламы в Instagram. В рамках этого изменения мы обновили перечисленные ниже конечные точки и поля.

Следующие конечные точки теперь могут возвращать ID пользователя Instagram (IG User) при его наличии:

• GET /<ad_account_id>/connected_instagram_accounts;
• GET /<business_id>/instagram_business_accounts;
• GET /<ad_creative_id>.

Следующие конечные точки теперь принимают в качестве параметров ID медиафайла Instagram (IG Media) и ID пользователя Instagram (IG User):

• POST /<ad_account_id>/adscreatives;
• POST /<ad_account_id>/ads.

Следующая конечная точка теперь принимает в качестве параметра ID медиафайла Instagram (IG Media):

• POST /<ad_account_id>/advideos.

Следующее поле теперь может возвращать ID пользователя Instagram (IG User) при его наличии:

• GET /<page-id>?fields=connected_page_backed_instagram_account.

Реклама для лидов

Получение лидов для приложений в режиме разработки

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

Начиная с версии 9.0 больше нельзя получать лидов, если приложение находится в режиме разработки. Для тестирования пользователи приложения в режиме разработки могут работать с лидами, предоставленными другим пользователем, имеющим роль в этом приложении. См. статью о ролях в приложении. У приложений в рабочем режиме по-прежнему будет доступ ко всем лидам.

Для бизнес-приложений действуют другие правила, поскольку у них нет режима разработчика и рабочего режима. Если у вас бизнес-приложение, нужно запросить Расширенный доступ для разрешения leads_retrieval, чтобы можно было получать лиды.