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

Сегодня мы выпускаем API Graph 10.0 и API Marketing 10.0 для Facebook.

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

Ниже приведена подробная информация обо всех изменениях. Технические спецификации см. в журнале изменений для версии 10.0.

Подробные сведения о нашей платформе для разработчиков см. в Разделе инициатив платформы.

Объявления и обновления

Обязательная проверка использования данных

Чтобы не потерять доступ к API Платформы Facebook, пройдите проверку использования данных в течение 60 дней с момента регистрации. Для этого нужно перейти на страницу "Мои приложения" на Панели приложений.

Прошлой осенью компания Facebook ввела новую проверку использования данных, которую разработчики должны проходить ежегодно для подтверждения своего права на доступ к API и того факта, что они обрабатывают данные в соответствии с Условиями использования платформы и Правилами для разработчиков Facebook.

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

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

Уровни и ограничения режима 90-дневного доступа к данным для API Groups

Начиная с 24 мая 2021 г. при работе с API Groups возможность доступа приложений к данным будет ограничена интервалом в 90 дней.

Мы также вводим многоуровневый доступ к API Groups для потребительских приложений в зависимости от того, в каком режиме: разработки или рабочем — они находятся. Разрешения API Groups теперь работают аналогично правам стандартного и расширенного доступа для бизнес-приложений.

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

С 24 мая 2021 г. приложениям в режиме разработки будет доступен только их собственный контент в общедоступных группах, а также в закрытых группах, в которых разработчик является администратором. Это означает, что приложение потеряет доступ к контенту, размещенному другими пользователями групп (не имеющими ролей в данном приложении), такому как публикации и комментарии.

Подробные сведения см. в журнале изменений для версии 10.0.

Уровни доступа для public_profile и разрешения электронной почты для бизнес-приложений

В рамках нашей текущей стратегии по защите пользовательских данных мы добавили поля public_profile (т. е. поля общедоступного профиля по умолчанию) и разрешения для доступа к электронной почте в модель уровней доступа, о которой объявили с выпуском Graph 8.0, для новых и существующих бизнес-приложений.

Теперь новым приложениям типа "бизнес" назначается стандартный доступ для public_profile и разрешений электронной почты. Когда у приложения есть стандартный доступ к данным public_profile, искать его и входить в него могут только пользователи с ролью в данном приложении или в компании, которая заявила на него права. Если вам необходимо, чтобы в приложение могли входить внешние пользователи, его администраторы могут запросить расширенный доступ на Панели приложений. Такой доступ будет предоставлен автоматически.

Подробные сведения см. в журнале изменений для версии 10.0.

Напоминания о запросах на удаление данных

Как было объявлено 10 ноября 2020 г., потребительские приложения и игры, отправляемые на проверку приложения или переводимые из режима разработки в рабочий режим, должны будут реализовать обратный вызов для запроса на удаление данных или URL с конкретными инструкциями для пользователей по поводу подачи такого запроса. Мы планируем внедрить это требование до 10 ноября 2022 г. и напомним об этом разработчикам за 60 дней до такого внедрения.

Изменение параметров API Graph AdsInsight для сокращения срока хранения данных

В пользовательском интерфейсе Ads Manager больше не будут поддерживаться отчеты по метрикам рекламы старше 37 месяцев. API будет возвращать ошибку для всех запросов, содержащих диапазоны дат, которые выходят за этот 37-месячный интервал. Мы упраздняем параметр date_preset = lifetime и заменяем его на date_preset = maximum.

Изменения API Graph 10.0 для AdsInsight, кроме параметра date_preset = lifetime, будут применены во всех остальных версиях API Graph через 90 дней. Обращения к этому полю не потребуют никаких изменений. Эта функция будет предопределена, и для всех вызовов со значением lifetime будет устанавливаться стандартный максимальный период хранения в 37 месяцев.

Это изменение не затронет данные, связанные с рекламными креативами, аудиториями, настройками показа и именами рекламных объектов; кроме того, никак не изменится расчет текущих метрик. Изменение будет применено во всех интерфейсах формирования отчетов по рекламе, включая Ads Manager, Ads Reporting и Lightweight Ad Experiences.

• Дата выпуска 23.02.2021:
  • версия 10.0:
    • добавление параметра date_preset = maximum;
    • упразднение параметра date_preset = lifetime;
    • возврат ошибки, когда запрос содержит явно заданные диапазоны дат, выходящие за 37-месячный интервал;
  • версии 9.0 и более ранние:
    • никаких изменений в текущих функциях.
• 90 дней после публикации: 24 мая 2021 г.:
  • версии 9.0 и более ранние:
    • добавление параметра date_preset = maximum (как и для новой версии);
    • возврат ошибки, когда запрос содержит явно заданные диапазоны дат, выходящие за 37-месячный интервал (как и для новой версии);
    • параметр date_preset = lifetime продолжает работать, но возвращает данные только за 37 месяцев (т. е. функционирует так же, как и параметр maximum).

Подробные сведения см. в журнале изменений для версии 10.0.

Новая политика удаления для данных внешних владельцев в ThreatExchange

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

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

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

См. дополнительные сведения об этих изменениях.

Изменения таргетинга в новых версиях API

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

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

Запуск новой страницы со статусом работоспособности платформы

Новая страница статуса продуктов Facebook для бизнеса повысит прозрачность и оперативность взаимодействия с внешними разработчиками, использующими продукты Платформы Facebook. На этой странице можно будет централизованно отслеживать состояние работающих на Платформе Facebook продуктов для бизнеса (Ads, WhatsApp Business API, Платформа Facebook для разработчиков и т. д.). В настоящее время эта страница содержит сведения для Ads Manager и WhatsApp Business API, а дополнительные продукты для бизнеса будут добавлены в мае 2021 г.

Упраздненные функции

Упразднение диалога "В эфир"

24 мая 2021 г. мы упраздняем SDK диалога "В эфир". Этот устаревший инструмент будет упразднен из всех версий API. Это изменение затронет только трансляции в прямом эфире на Facebook. Мы предлагаем разработчикам перейти на Live Producer и Live API во всех индивидуальных решениях для трансляции.

Для решений, которые будут введены после упразднения SDK диалога "В эфир":

• инструмент Live Producer доступен непосредственно через страницу facebook.com/live/producer (или другие точки входа на Facebook, такие как кнопка "Прямой эфир" на странице или в профиле);
• возможна интеграция любого пользовательского решения с Live API.

Подробные сведения см. в журнале изменений для версии 10.0.

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

24 мая 2021 г. будет прекращена поддержка таргетинга по связям при создании и редактировании групп объявлений. Это изменение затронет только новые и редактируемые кампании; существующие кампании продолжат работать в прежнем режиме.

Подробные сведения см. в журнале изменений для версии 10.0.

Восстановленные функции

Восстановление конечной точки gr:delete:Page/tabs

При выпуске API Graph версии 8.0 мы упразднили конечную точку gr:delete:Page/tabs для вкладок страниц. Мы решили восстановить ее в версии API Graph 10.0 (это изменение вступает в силу немедленно), а 24 мая 2021 г. возобновим доступ к ней во всех прочих версиях Graph.

Подробные сведения см. в журнале изменений для версии 10.0.

Восстановление конечных точек gr:post:Business/business_users, gr:post:Business/system_users и gr:post:User/access_tokens

При выпуске API Graph 9.0 мы ограничили доступ к трем конечным точкам для компаний:

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

С выпуском Graph 10.0 мы снова откроем их для вызовов API из приложений, для которых выполняется одно из двух следующих условий:

• целевая компания является владельцем вызывающего приложения;
• целевая компания является дочерней компанией (в рамках двухуровневой бизнес-модели) компании-владельца вызывающего приложения.

Подробные сведения см. в журнале изменений для версии 10.0.

Календарь действий

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

В рамках графика поддержки различных версий API Marketing будут упразднены его следующие версии:

• 3 марта 2021 г.: будет упразднена и удалена с платформы версия API Marketing 7.0;
• 4 мая 2021 г.: будет упразднена и удалена с платформы версия API Marketing 8.0;
• 25 августа 2021 г.: будет упразднена и удалена с платформы версия API Marketing 9.0.

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

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

В рамках графика поддержки различных версий API Graph будут упразднены его следующие версии:

• 4 мая 2021 г.: будет упразднена и удалена с платформы версия API Graph 3.2;
• 3 августа 2021 г.: будет упразднена и удалена с платформы версия API Graph 3.3.

Упразднение других функций и возможностей

• 24 мая 2021 г.:
  • будет упразднен и удален с платформы диалог "В эфир";
  • будет упразднена и удалена с платформы функция таргетинга по связям.

Что требуется от разработчиков

• Постепенная регистрация: обязательная проверка использования данных:
  • после регистрации проверку необходимо пройти в течение 60 дней;
  • подробности см. в разделе часто задаваемых вопросов о проверке использования данных.
• 23 февраля 2021 г.: внедрение изменений API Graph AdsInsight только для версии Graph 10.0.
• 24 мая 2021 г.:
  • внедрение изменений API Graph AdsInsight для версии Graph 9.0 и более ранних;
  • вступление в силу изменений в уровнях доступа на основе проверки приложений:
    • ограничение доступа к данным при работе с API Groups интервалом в 90 дней;
    • реализация многоуровневой системы доступа к данным для API Groups;
    • вступление в силу изменений для public_profile и разрешений электронной почты для бизнес-приложений;
  • реализация новой политики безвозвратного удаления данных в ThreatExchange.
• 10 ноября 2022 г.: крайний срок реализации запросов на удаление данных.