Graph API

Версия 3.1

Выпуск: 26 июля 2018 г. | Доступно до: 27 октября 2020 г. | Запись в блоге

Общие

Эти изменения относятся к версии 3.1 и более поздним. С 24 октября 2018 г. они будут распространяться на все версии.

Все конечные точки API Graph теперь возвращают все пустые структуры в виде {} и все пустые списки в виде [].

Live API

Эти изменения относятся к версии 3.1 и более поздним. С 24 октября 2018 г. они будут распространяться на все версии.

Параметр type упразднен для перечисленных ниже границ контекста. Он заменен новым параметром source.

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

Параметр source может принимать одно из двух значений: target или owner. При запросе к границе контекста /live_videos с параметром source=target возвращаются прямые эфиры, транслируемые в этот узел, а при запросе с параметром source=owner — транслируемые этим узлом.

Узлы "Событие" и "Группа" поддерживают запросы только со значением target. Некоторые запросы со значением target могут возвращать ошибку, если у вас нет разрешения на просмотр целевого узла.

API Marketing

Выпуск: 26 июля 2018 г. | Доступно до: 14 мая 2019 г. | Запись в блоге

Управление рекламой

  • Категории таргетинга на основе поведения. Упразднены некоторые варианты таргетинга на основе поведения, используемые в behaviors. При попытке создать рекламу с какой-либо из этих категорий вы получите ошибку The category you selected is no longer available. Чтобы проверить, какие категории доступны для таргетинга, используйте поиск настроек таргетинга.

  • Упразднено значениеPAGE_ENGAGEMENTдля поляoptimization_goal. Мы больше не поддерживаем значение PAGE_ENGAGEMENT для поля optimization_goal в рекламных кампаниях. Начиная с версии 3.1 вы не сможете создавать, обновлять и копировать рекламные кампании со значением PAGE_ENGAGEMENT для параметра optimization_goal. Если у вас имеются рекламные кампании, созданные в версии до 3.1, вы сможете по-прежнему использовать их с этой настройкой. Также по-прежнему можно использовать PAGE_ENGAGEMENT в качестве разбивки API Insights для данных существующих рекламных кампаний с этим значением optimization_goal.

  • Упразднены рекламные объявления с целью "Отметки «Нравится» Страницы" с одним изображением без публикации. Начиная с версии 3.1 вы не можете создавать рекламные объявления с целью "Отметки «Нравится» Страницы" с одним изображением без публикации Страницы. Вместо этого следует создавать рекламу с целью "Отметки «Нравится» Страницы" с публикацией (см. статью Креатив, место размещения и предпросмотр: создание рекламы с целью "Отметки «Нравится» Страницы").

  • Прекращено получение рекламы для лидов через Webhooks на уровне разработки. Мы больше не будем отправлять через Webhooks данные, собранные из форм рекламы для лидов, если приложение находится в режиме разработки. Это изменение вступит в силу 1 февраля 2019 г.

    • Если вы подписаны на обновления в версии 3.1, мы будем отправлять их только для рабочих версий приложений, находящихся в рабочем режиме.

    • Если вы создадите новое приложение после выхода версии 3.1, мы будем отправлять обновления только для рабочей версии приложения, находящейся в рабочем режиме.

    • Если у вас уже есть приложение, его необходимо перевести в рабочий режим до 1 февраля 2019 г. До этого момента вы будете получать обновления в режиме разработки.

    Дополнительную информацию об уровнях доступа и работы приложений в API Marketing см. в статьях Новая структура доступа для API Marketing и API Marketing: доступ и аутентификация.

Статистика рекламы и измерения

  • Мы переименовали cost_per_store_visit и store_visits в API Insights в cost_per_store_visit_actions и 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 Store Visits и соответствующая документация доступны в ограниченном режиме. Для получения доступа обратитесь к представителю Facebook.

API Business Manager

В версии 3.1 мы представили новую концепцию разрешений на базе задач, которые должны заменить текущую модель разрешений на базе ролей. Это затронет доступ к рекламным аккаунтам, управляемым с помощью API Business Manager и Страниц. Модель доступа к рекламным аккаунтам и Страницам на базе ролей будет по-прежнему доступна, однако в будущем ее поддержка будет прекращена. Это изменение затрагивает перечисленные ниже роли, взамен которых для рекламных аккаунтов теперь будут доступны эквивалентные задачи.

Роль Задачи Описание

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

Управление всеми аспектами рекламных кампаний, отчетности, биллинга и разрешений для рекламного аккаунта.

GENERAL_USER

['ADVERTISE', 'ANALYZE']

Создание рекламы с использованием источника финансирования, связанного с рекламным аккаунтом. Создание отчетов.

GENERAL_USER

['ANALYZE']

Создание отчетов.

Указанные ниже роли в API Business Manager будут заменены соответствующими задачами.

Роль Задачи

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

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

Роль Задачи

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

В рамках этого изменения мы прекращаем поддержку перечисленных ниже полей API Business Management и заменяем их указанными ниже полями.

Параметр Упразднено Новое поле

GET {adaccount-id}/users

permissions, role

tasks

POST {adaccount-id}/users

role, uidRoles, emailRoles

tasks

GET {user-id}/adaccounts

permissions, role

tasks

GET {user-id}/assigned_ad_accounts

role, permitted_role

tasks, permitted_tasks

GET {user-id}/assigned_pages

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

Эта новая схема также затрагивает API Pages (см. статью API Graph 3.1, API Pages: важные изменения). Документация по API Business Manager:

Платформа Messenger

Для приложений, созданных до 26 июля 2018 г., эти изменения вступают в силу 8 января 2019 г. Для приложений, созданных после этой даты, они вступают в силу немедленно.

API User Profile теперь по умолчанию возвращает только поля first_name, last_name и profile_pic. Для получения других полей требуется проверка продукта. Она выполняется на панели приложений на вкладке платформы Messenger.

Поля last_ad_referral и is_payment_enabled упразднены и будут удалены из API 30 октября 2018 г.

API Mutual Friends

Эти изменения относятся к версии 3.1 и более поздним. С 24 октября 2018 г. они будут распространяться на все версии.

API Mutual Friends был упразднен 4 апреля 2018 г. С этого дня перечисленные ниже конечные точки возвращали пустые наборы данных. Теперь эти конечные точки полностью упразднены и возвращают ошибку.

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

API Pages

Разрешения

Эти изменения относятся к версии 3.1 и более поздним. С 1 февраля 2019 г. они будут распространяться на все версии.

Разрешение pages_manage_cta теперь требует проверки приложения для всех запросов POST и DELETE. Приложения, созданные до 26 июля 2018 г. по-прежнему могут использовать это разрешение, однако для этого их необходимо отправить на проверку до 1 февраля 2019 г, чтобы продолжать использовать pages_manage_cta.

Роли на Странице

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

Роли на Странице в настоящее время упраздняются и заменяются задачами на Странице. Вместо предоставления пользователю роли на Странице теперь необходимо предоставлять соответствующие задачи.

РольСоответствующие задачи

Admin

ADVERTISE, ANALYZE, CREATE_CONTENT, MANAGE, MODERATE

Advertiser

ADVERTISE, ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE, ANALYZE, CREATE_CONTENT, MODERATE

Moderator

ADVERTISE, ANALYZE, MODERATE

Пока разрешения на основе ролей не будут полностью заменены разрешениями на основе задач, через /page/roles необходимо предоставлять все соответствующие роли задачи. В противном случае операцию POST выполнить не удастся.

Для поддержки этих изменений поля perms и role упразднены и заменены новым полем tasks. Это затрагивает следующие границы контекста:

  • /me/accounts
  • /page/roles
  • /user/accounts

Узнать, как эти изменения влияют на API Marketing и API Business Manager, можно в журнале изменений API Marketing.

Webhooks

Эти изменения относятся к версии 3.1 и более поздним. С 24 октября 2018 г. они будут распространяться на все версии.

Следующие поля Webhook пользователя упразднены:

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

Следующие поля Webhook пользователя теперь используют URL с HTTPS вместо HTTP:

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

Кроме того, URL для этих полей теперь имеют срок действия. Это изменение вступает в силу для всех версий API немедленно.