圖形 API

第 2.10 版

圖形 API | 行銷 API

變更紀錄項目分為以下類別：

  • 新功能 — 新產品或服務，包括新的節點、關係連線和欄位。
  • 變更項目 — 對既有產品或服務的變更（不包括淘汰項目）。
  • 淘汰項目 — 要移除的既有產品或服務。
  • 90 天期限重大變更 — 版本發佈日期 90 天之後會生效的變更和淘汰項目。

新功能、變更項目和淘汰項目只會影響這個版本。90 天期限重大變更會影響所有版本。

此處並未包括重大變更，因為重大變更並非與特定版本相關聯。

圖形 API

發佈日期：2017 年 7 月 18 日 | 有效期限：2019 年 11 月 7 日

新功能

Webhook

  • 為粉絲專頁事件新增 Webhook - 現在起，下列動作會觸發粉絲專頁「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

粉絲專頁

用戶

Webhook

  • 執行應用程式限制 — 指定存取權杖給不符合應用程式限制（例如國家／地區或年齡）的用戶將導致錯誤，除非在要求中有指定 appsecret_proof。

淘汰項目

活動

  • GET /{event-id}/videos — 此關係連線已移除。

90 天期限重大變更

留言

  • POST 和 DELETE /{comment-id} — 此節點現在會要求有效的粉絲專頁存取權杖。

  • POST and DELETE /{object-id}/comments — 此節點現在會要求有效的粉絲專頁存取權杖。

  • GET /{object-id}/comments — 此關係連線現在會要求有效的存取權杖。

網址

  • POST /{url} - 此節點現在會要求有效的存取權杖。

  • GET /{url} - 根據預設，系統不會再傳回 og_object，但必須將其納入欄位參數。

  • /{url} 抓取 - GET 要求將不再抓取網址，現在必須使用 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