Graph API

版本 2.10

Graph API | 推廣 API

變更記錄項目分類方式如下：

  • 新功能 — 新的產品或服務，包括新的節點、邊緣及欄位。
  • 變更 — 對現有產品或服務的變更（不含停用項目）。
  • 停用項目 — 即將移除的現有產品或服務。
  • 90 天重大變更項目 — 將於版本發佈日期 90 天後生效的變更和停用項目。

新功能、變更及停用項目只會影響這個版本，90 天重大變更項目則會影響所有版本。

重大變更項目與特定版本無關，因此不包含在此處。

Graph 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