Graph API

Версия 10.0

API Graph

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

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

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

Относится ко всем приложениям, созданным после 16 февраля 2021 г.

Всем бизнес-приложениям, созданным после 16 февраля 2021 года, будет автоматически предоставляться стандартный доступ к разрешениям email и public_profile.

Относится ко всем существующим приложениям, созданным до 16 февраля 2021 г.

Всем бизнес-приложениям, созданным до 16 февраля 2021 г., будет автоматически предоставлен расширенный доступ к разрешениям email и public_profile. У приложений, не использующих разрешения email и public_profile, будет стандартный уровень доступа к ним.

Бизнес-приложения могут получить расширенный доступ к email и public_profile, не проходя проверку.

Группы

Действует для версии 10.0 и более поздних. Начнет действовать для всех версий с 25 мая 2021 г.

  • В рамках соблюдения других политик Facebook в отношении хранения данных API Groups будет включать только данные публикаций, созданных в течение последних 90 дней. Набор возвращаемых данных зависит от уровня доступа или режима работы приложения, а также от вашей роли в нем.
  • Вместо доступа к API в режиме разработки или рабочем режиме теперь будет использоваться доступ на стандартном или расширенном уровне. Стандартный уровень позволяет получать данные только для пользователей, имеющих роль в приложении. Расширенный уровень позволяет получать данные всех пользователей группы, в которой установлено приложение.

Страницы

Восстановлена конечная точка

Действует для версии 10.0 и более поздних. Начнет действовать для всех версий с 25 мая 2021 г.

Конечная точка DELETE /{page-id}/tabs, упраздненная в версии 8.0, восстановлена в версии 10.0. 25 мая 2021 года она будет восстановлена для всех версий.

ThreatExchange

Удаление данных с истекшим сроком действия

Начнет действовать для всех версий с 25 мая 2021 г.

Данные, загружаемые на платформу ThreatExchange с ненулевым значением expire_time, будут удаляться без возможности восстановления по истечении указанного срока действия. Если вы хотите сразу удалить данные, которые более не являются действительными, установите в качестве значения поля expired_on текущее время.

Кроме того, все не принадлежащие Facebook объекты ThreatDescriptor будут удаляться без возможности восстановления по истечении срока действия, установленного их создателем. Если сейчас в вашем приложении есть объекты ThreatDescriptor с истекшим сроком действия и вы не хотите удалять их, потребуется передвинуть этот срок или установить для него значение 0, чтобы указать, что данные остаются действительными бессрочно.

URL

Действует для версии 10.0 и более поздних. Начнет действовать для всех версий с 25 мая 2021 г.

Поле engagement

  • Из соображений безопасности значения количества, возвращаемые запросом GET /?id={url}/engagement, могут не соответствовать примерным значениям.
  • К полю GET /?id={url}/engagement для одного URL-адреса можно будет отправить не более 10 запросов в час.

API Marketing

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

Рекламный аккаунт

Изменения полей

Действует для версии 10.0 и более поздних. Начнет действовать для всех версий с 25 мая 2021 г.

Для выполнения любых операций с полем agency_client_declaration в узле AdAccount теперь необходимы права администратора.

API Ads Insights

Обновление параметра date_preset

Действует для версии 10.0 и более поздних.

  • Параметр lifetime (date_preset=lifetime) отключен и заменен параметром date_preset=maximum, который позволяет загрузить данные за период до 37 месяцев. Для всех запросов, содержащих диапазоны дат, выходящие за пределы этого 37-месячного интервала, API будет возвращать ошибку.
  • Функциональность в версии 9.0 и более ранних не изменится до 25 мая 2021 г. С этого дня будет введен параметр date_preset=maximum, и для всех вызовов lifetime по умолчанию будет использоваться атрибут maximum и возврат данных за период до 37 месяцев.

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

Смягчение действовавших ранее ограничений на доступ к конечным точкам

Действует для версии 10 и более поздних.

В версии 9.0 доступ к перечисленным ниже конечным точкам был ограничен. Теперь доступ к ним имеют все приложения, однако они могут осуществлять таргетинг только на компании, заявившие свои права на них (или их дочерние компании):

Таргетинг

Таргетинг по контактам

Начнет действовать для всех версий с 24 мая 2021 г.

Для следующих конечных точек прекращается поддержка таргетинга по контактам при создании и изменении рекламных кампаний:

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

Похожие аудитории

ОБНОВЛЕНИЕ ОТ 28 АПРЕЛЯ 2021 Г. Удаление параметров location_spec и country для похожих аудиторий отложено. О том, когда эти параметры будут удалены, мы сообщим позднее.

При создании похожих аудиторий больше нельзя будет использовать параметры location_spec и country. Местоположение для похожих аудиторий будет зависеть от страны, указанной в параметрах таргетинга кампании.

Это изменение не затронет уже существующие кампании. Оно распространяется только на новые или измененные кампании.

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

  • POST /<ad_account_id>/customaudiences
  • POST /<ad_account_id>/adsets
  • POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
  • GET /<ad_account_id>/reachestimate
  • GET /<ad_account_id>/delivery_estimate
  • GET /<ad_account_id>?fields=approximate_count
  • GET /<ad_account_id>?fields=delivery_status
  • GET /<ad_account_id>?fields=operation_status

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