Версия 11.0

Graph API

Выпуск: 8 июня 2021 г. | Доступно до: 14 сентября 2023 г. | Запись в блоге

Потребительские приложения

Уровни доступа

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

В ближайшие недели уровни доступа будут распространены на все существующие приложения для потребителей. Для этих приложений будут автоматически утвержден расширенный уровень для разрешений и функций, уже утвержденных в рамках проверки приложения. Для всех прочих разрешений и функций будет автоматически утвержден стандартный уровень доступа.

В ближайшие недели уровни доступа также будут распространены на все новые приложения. Для всех создаваемых приложений будет автоматически утверждаться расширенный уровень для разрешений email и public_profile. Однако по умолчанию для обоих этих разрешений будет устанавливаться стандартный уровень доступа, и, чтобы их можно было запрашивать у пользователей, у которых нет ролей в приложении, расширенный доступ для них нужно будет выбрать вручную.

Поддержка разработчиков

Мы выпустили инструмент отслеживания статуса Facebook for Business, который позволяет контролировать работоспособность платформ и продуктов для бизнеса, таких как Ads Manager, WhatsApp Business и платформа Facebook for Developers.

Facebook Analytics

Упраздненный элемент

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

С 30 июня 2021 года инструмент Facebook Analytics будет недоступен. Кроме того, мы упраздняем плагин панели приложений для Marketing API. Подробнее см. в Справочном центре для бизнеса.

Следующие поля узла приложения больше не доступны:

• analytics_config
• analytics_platform_metrics_config
• permissible_ad_accounts

Следующие конечные точки больше не доступны:

• GET Application/analytics_cohort_query
• GET Application/analytics_entity_user_config
• GET Application/analytics_event_types
• GET Application/analytics_funnel_query
• GET Application/analytics_query
• GET Application/analytics_segments

API Instagram Basic Display

Отладчик маркеров доступа

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

Отладчик маркеров доступа при отладке маркера теперь возвращает только ID внутри приложения.

Управление версиями API

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

В API теперь поддерживается возможность вызова разных версий. Чтобы использовать в запросе определенную версию API, укажите ее номер в пути запроса после базового URL. Пример:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

При запросе без указания версии используется версия, заданная в параметре Панель приложений > Настройки > Расширенные > Обновление версии API вызывающего приложения.

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

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

Введены ID пользователей внутри приложения (ASID). ASID заменят собой обычные ID пользователей примерно через два года после упразднения версии 10.0, поэтому рекомендуем вам начать замену обычных ID пользователей ваших приложений на эквивалентные ASID.

• Запросы с использованием обычных ID пользователей поддерживаются во всех версиях.
• Запросы на основе ASID поддерживаются только в вызовах версии 11.0 и более поздних.
• Идентификатор ASID будет возвращаться в ответ на вызов версии 11.0 и более поздних даже при запросе обычного ID пользователя.

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

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

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

Graph API для Instagram

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

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

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

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

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

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

Instant Experiences

Шаблоны

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

Бета-тестирование шаблонов Instant Experience завершено. Теперь они доступны всем разработчикам.

Платформа Messenger

Webhooks обратной передачи данных в сообщениях

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

В Webhooks messaging_postbacks добавлено поле mid, благодаря которому приложение может получить ID сообщения.

Упразднение шаблонов для авиакомпаний

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

Вызовы к POST /{page-id}/messages, содержащие любой шаблон для авиакомпаний (template_type типа airline_boardingpass, airline_checkin, airline_itinerary или airline_update), будут завершаться ошибкой.

oEmbed

Новая функция oEmbed Read

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

Продукт oEmbed заменен новой функцией oEmbed Read. Если вы внедрили продукт oEmbed до 8 июня 2021 г., вы должны пройти проверку приложения для использования функции oEmbed Read до 7 сентября 2021 г. Если вы не получите разрешение на использование функции oEmbed Read до 7 сентября 2021 г., ваша реализация oEmbed перестанет загружаться.

Pages API

ID комментариев

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

Поле id для комментариев не будет возвращаться для приложений, которые используют только функцию доступа к общедоступному контенту Страниц для отправки запросов к конечным точкам Pages (например, поля id/PAGEPOST-ID/comments и /COMMENT-ID/comments). Для получения поля id для комментариев к публикациям Страницы у пользователя приложения должны быть права модератора на соответствующей Странице.

Новая версия Страниц

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

Большинство конечных точек API Pages поддерживают как классическую, так и новую версию Страниц. Для конечных точек, поддерживающих новую версию, в справочном описании присутствует раздел "Новая версия Страниц".

Следующие конечные точки не поддерживают новую версию Страниц:

• /PAGE-ID/likes
• /PAGE-ID/global_brand_children
• /PAGE-ID/locations
• /PAGE-ID/tabs
• /PAGE-ID/visitor_posts

В новой версии недоступны некоторые поля Страниц. При вызове для них будет возвращаться null, другой набор данных или ошибка. Список этих полей см. в нашем обзоре новой версии Страниц.

Разрешения

user_likes

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

Изменены правила допустимого использования разрешения user_likes. Начиная с 7 сентября 2021 г. это разрешение будет отозвано для приложений, для которых оно было одобрено ранее, если они нарушают новые правила его использования.

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

user_posts

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

Изменены правила допустимого использования разрешения user_posts. Начиная с 7 сентября 2021 г. это разрешение будет отозвано для приложений, для которых оно было одобрено ранее, если они нарушают новые правила его использования.

• Старые правила допустимого использования: значимое улучшение взаимодействия пользователя с приложением (пользователь должен понимать, как используются его данные для достижения этой цели).
• Новые правила допустимого использования: возможность для пользователей создавать физические или цифровые альбомы на основе своей хроники и делиться воспоминаниями из нее на Facebook или в других социальных приложениях.

SDK

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

Marketing API

Выпуск: 8 июня 2021 г. | Доступно до: 23 февраля 2022 г. | Запись в блоге

Аудитории

Удаление пользовательских, похожих и сохраненных аудиторий

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

Начиная с 8 июня 2021 г. все пользовательские, похожие и сохраненные аудитории, которые не использовались в активных группах объявлений в течение более чем двух лет, помечаются как аудитории с истекающим сроком действия. После добавления такой пометки планируется удаление соответствующей аудитории через 90 дней.

Разработчики смогут фильтровать свои аудитории по статусу истечения срока действия с помощью поля operation_status и отслеживать их ориентировочное время удаления в системе с помощью поля delete_time. Разработчики также смогут самостоятельно удалять такие аудитории до наступления соответствующего срока или использовать их в активной группе объявлений, чтобы предотвратить удаление. После удаления аудитории рекламодатель не сможет повторно активировать ее.

Для пользовательских аудиторий (кроме основанных на собственном списке), похожих и сохраненных аудиторий:

• Если рекламодатель захочет, чтобы помеченные аудитории автоматически удалялись после 6 сентября 2021 г., ему не нужно предпринимать никаких действий. Однако при желании рекламодатель может удалить аудиторию и до наступления соответствующего срока.
• Помеченные аудитории, которые рекламодатель хочет сохранить, следует добавить в активную группу объявлений до 6 сентября 2021 г.

Для пользовательских аудиторий на основе собственного списка:

• Мы храним эти аудитории по поручению рекламодателей в соответствии с их инструкциями. Если рекламодатель не предпримет никаких действий для использования помеченных аудиторий в активных группах объявлений до 6 сентября 2021 г., мы расценим это как инструкцию по их удалению.

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

• GET /{custom-audience-id}
• GET /act_{ad-account-id}/customaudiences?filtering
• GET /act_{ad-account-id}/saved_audiences?filtering
• GET /{saved-audience-id}

Дополнительные сведения об этих изменениях см. в описании изменений, связанных с удалением пользовательских аудиторий, в статье с обзором аудиторий.

API Business

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

Мы временно ограничиваем доступ к перечисленным ниже конечным точкам. Он сохранится только у приложений, которые успешно выполняли вызовы к ним в течение последних 30 дней.

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

Все прочие приложения при вызове к этим конечным точкам будут получать ошибку.

API Catalog

Упразднение поля ассортимента товаров

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

Поле inventory будет упразднено и заменено новым полем quantity_to_sell_on_facebook. В ближайшее время мы по-прежнему будем поддерживать поле inventory, однако рекомендуем вам перейти на новое поле quantity_to_sell_on_facebook.

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

• GET /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

Дополнительные сведения об этом изменении см. в описании поля количества для продажи и в обзоре поддерживаемых полей для товаров в динамической рекламе и торговле.

Удаление непустых групп товаров

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

Мы более не будем разрешать по умолчанию удалять непустые группы товаров. Для удаления непустой группы к запросу на удаление потребуется применить deletion_method=delete_items. В результате будет удалена как группа товаров, так и ее содержимое.

Изменение затронет следующую конечную точку:

• DELETE /<product_group_id>

Удаление активных групп товаров

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

Мы более не будем разрешать по умолчанию удалять каталоги с активными группами товаров. Чтобы удалить каталог, содержащий активную группу товаров, для параметра allow_delete_catalog_with_live_product_set этого каталога потребуется установить значение true.

Это изменение повлияет на следующую конечную точку:

• DELETE /<product_catalog_id>

Новая конечная точка для диагностики

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

Мы добавили новую конечную точку GET /{product_catalog_id}/diagnostics. Она позволяет получить диагностические данные для определенного каталога, например сведения о причинах, по которым товары не отображаются в каналах, и о возможностях повысить доступность товаров для поиска.

API Commerce

Информация о прогнозируемой совокупной сумме платежа по заказу

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

Мы меняем способ отображения информации о прогнозируемой совокупной сумме платежа по заказу для вызовов к конечной точке {commerce-order-id}/?fields=estimated_payment_details. Ранее, если заказ не был выполнен, использовалась прогнозируемая сумма налога, а для выполненных заказов — сумма налога по выполненному заказу. Начиная с версии 11.0 эта конечная точка всегда будет возвращать прогнозируемый налог. Обратите внимание, что сведения о налоге по выполненному заказу можно получить с помощью {commerce-order-id}/items?fields=tax_details.

Инструмент "Прирост конверсий"

Изменения в метриках

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

Изменены метрики, возвращаемые для поля GET /{objective-id}/?fields=result.

Следующие метрики добавлены:

• conversions_incremental_share
• conversions_CPiC
• conversions_multicell_confidence
• conversions_multicell_rank
• sales_incremental_share
• sales_multicell_confidence
• sales_multicell_rank
• buyers_incremental_share
• buyers_CPiB
• buyers_multicell_confidence
• buyers_multicell_rank

Следующие метрики удалены:

• advancedBuyers.control
• ancedBuyers.informativeMultiCellBayesianConfidence
• advancedBuyers.lift
• advancedBuyers.test
• advancedConversions.control
• advancedConversions.informativeMultiCellBayesianConfidence
• advancedConversions.lift
• advancedConversions.test
• advancedSales.control
• advancedSales.informativeMultiCellBayesianConfidence
• advancedSales.lift
• advancedSales.test
• buyers.baseline
• buyers.bayesianCILower
• buyers.bayesianCIUpper
• buyers.control
• buyers.delta
• buyers.incremental
• buyers.isStatSig
• buyers.lift
• buyers.multiCellBayesianConfidence
• buyers.reachedPercent
• buyers.singleCellBayesianConfidence
• conversions.baseline
• conversions.bayesianCILower
• conversions.bayesianCIUpper
• conversions.control
• conversions.delta
• conversions.incremental
• conversions.isStatSig
• conversions.lift
• conversions.multiCellBayesianConfidence
• conversions.reachedPercent
• conversions.singleCellBayesianConfidence
• frequency
• incrementalROAS
• sales.baseline
• sales.bayesianCILower
• sales.bayesianCIUpper
• sales.control
• sales.delta
• sales.incremental
• sales.isStatSig
• sales.lift
• sales.multiCellBayesianConfidence
• sales.singleCellBayesianConfidence

Следующие метрики переименованы:

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

Insights API

Упразднение метрик посещения точек

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

Упразднены метрики store_visits_actions и cost_per_store_visit_actions.

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

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

API Offer Ads

Упразднение конечных точек API Offer Ads

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

Мы постоянно повышаем стабильность наших сервисов и в рамках этой деятельности 8 июня 2021 года завершаем поддержку продукта "Реклама предложений". Для распространения информации о ваших скидках как в обычных магазинах, так и в онлайн-магазинах, мы рекомендуем использовать стандартную рекламу на Facebook. Информацию о скидках, их сроках действия и местах возможного использования, а также промокоды следует размещать прямо в креативе на уровне объявления.

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

• GET /{page-id}/nativeoffers
• POST /[page-id}/nativeoffers
• GET /pagename/nativeoffers
• GET /{native-offer-id}
• GET /{native-offer-id}/views
• POST /{native-offer-id}/codes
• POST /{native-offer-id}/nativeofferviews
• GET /{offer-id}/comments
• GET /{offer-id}/sharedposts
• GET /{offer-id}/likes