Graph API

Версия 2.10

API Graph | API Marketing

Записи в журнале изменений разделяются на следующие категории:

  • Новые функции: новые продукты или услуги, включая новые узлы, поля и границы контекста.
  • Изменения: изменения существующих продуктов или услуг (за исключением упраздненных элементов).
  • Упраздненные элементы: существующие продукты или услуги, которые будут упразднены.
  • Важные изменения за 90 дней: изменения, которые вступят в силу через 90 дней после даты выпуска версии (в эту категорию входят и случаи упразднения элементов).

Категории Новые функции, Изменения и Упраздненные элементы относятся только к этой версии. Категория Важные изменения за 90 дней относится ко всем версиям.

Категория Важные изменения здесь не упоминается, так как она не привязана к определенным выпускам.

API Graph

Выпуск 18 июля 2017 г. | Доступно до 7 ноября 2019 г.

Новые функции

Webhooks

  • Webhooks для мероприятий на Странице — следующие действия теперь приводят к обновлению подписок поля feed Страницы:

    • Автопубликация запланированного мероприятия
    • Комментирование публикации о мероприятии
    • Создание и публикация мероприятия
    • Публикация черновика мероприятия

Изменения

Распределение кредитов

  • GET /{extended-credit-id} — переименованы следующие поля:

    • invoice_email заменено на extended_credit_emails
    • invoice_group заменено на extended_credit_invoice_groups
    • sequential_liability_amount заменено на allocated_amount

  • GET /{extended-credit-id} — добавлены следующие поля:

    • liable_biz_name fields
    • owner_business field с полями второго уровня id и name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name

  • GET /{extended-credit-id} — удалено следующее поле:

    • business_id field

  • extended_credit_invoice_groups — добавлены следующие поля второго уровня:

    • ad_accounts с полями второго уровня account_id и name
    • email
    • id
    • name

  • CurrencyAmount — следующие поля теперь возвращают объект CurrencyAmount, а не только сумму:

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Страницы

Пользователь

Webhooks

  • Соблюдение ограничений приложения —указание маркера доступа для пользователя, не соответствующего ограничениям приложения (таким как страна или возраст), будет приводить к ошибке, если только в запросе не указано свойство appsecret_proof.

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

События

  • GET /{event-id}/videos — эта граница контекста удалена.

Важные изменения за 90 дней

Комментарии

  • POST и DELETE /{comment-id} — для этого узла теперь необходим действительный маркер доступа к Странице.

  • POST and DELETE /{object-id}/comments — для этого узла теперь необходим действительный маркер доступа к Странице.

  • GET /{object-id}/comments — для этой границы контекста теперь необходим действительный маркер доступа.

URL-адреса

  • POST /{url} — для этого узла теперь необходим действительный маркер доступа.

  • GET /{url} — og_object больше не возвращается по умолчанию (его нужно указывать в параметре полей).

  • Скрапинг/{url} — запросы GET теперь не выполняют скрапинг URL. Для этого нужно использовать POST /{url}.

Публикации

  • /{post-id} — для этого узла теперь необходим действительный маркер доступа.

Видео

  • /{video-id} — для этого узла теперь необходим действительный маркер доступа к Странице.

Marketing API

Released July 18, 2017 | Available until May 8, 2018

New Features

  • No new features.

Changes

  • No changes.

Deprecations

  • No deprecations.

90-Day Breaking Changes

  • No 90-day breaking changes.

Breaking Changes in Marketing API v2.10

Ads Management

  • Holdout fields - The following fields have been deprecated from POST /{ad_account_id}/ads and GET /{ad_id}:

    • holdout_end
    • holdout_hash
    • holdout_start
    • no_show_offset
    • no_show_percentage
    • show_end
    • show_start

  • POST /{ad_account_id}/adcreatives - The following parameter is now deprecated:

    • follow_redirect

  • creative_rotation_parameter and creative_rotation type from GET ADSET_ID and POST AD_ACCOUNT_ID/adsets are deprecated.

  • Real-time bidding partner GET endpoints are deprecated. This includes GET /RTB_PARTNER_ID and GET /RTB_PARTNER_ID/stats endpoints. We also removed the field rtb_flag from POST /ADSET_ID and POST /ADGROUP_ID.

Signals and Targeting

  • Reach and Frequency Predictions - As of 2.10 we now provide target_spec as a JSON object; you no longer have to parse the response into JSON.

Insights

  • Breakdowns - The following types have been deprecated for the action_link_click_destination breakdown. See Insights, Breakdowns.

    • app_store_clicks
    • deeplink_clicks
    • website_clicks

Replaced by:

  • click_to_app_store
  • click_to_app_deeplink
  • click_to_website