第 7.0 版

圖形 API

發佈日期:2020 年 5 月 5 日 | 有效期限:2022 年 8 月 4 日 | 部落格文章

Facebook Business 擴充功能第 2 版

此變更適用於所有版本。

Facebook Business 擴充功能第 2 版已新增兩個欄位。

  • 廣告帳號編號ad_account_id)— 代表用戶在 FBE 內選擇的廣告帳號編號。如果您的應用程式擁有 ads_management 權限,則可使用此廣告帳號來管理廣告。

  • 目錄編號catalog_id)— 用戶在 FBE 內選擇的目錄編號。此編號可用來管理其商品目錄。

Instagram

主題標籤搜尋

此變更適用於 7.0 以上版本。

您現在可以在 GET /{ig-hashtag-id}/top_mediaGET /{ig-hashtag-id}/recent_media主題標籤搜尋查詢所傳回的 IG 媒體上要求 timestamp 欄位。例如:GET /{ig-hashtag-id}/top_media?fields=timestamp

Messenger

顧客洽談外掛程式

此變更適用於 7.0 以上版本,並於 2020 年 11 月 2 日套用至所有版本。

透過顧客洽談外掛程式開始新的對話或繼續現有的對話時,初始 messaging_postbacksmessaging_referrals Webhook 通知會包含用戶的匿名 user_ref 編號,而不是用戶的粉絲專頁範圍編號(PSID)。用戶傳送訊息後,後續的 Webhook 通知將會包含用戶的 PSID。

粉絲專頁 Messenger 個人檔案

此變更適用於 7.0 以上版本。

粉絲專頁 Messenger 個人檔案上的 home_url 屬性已停用於所有作業(GETPOSTDELETE)。

開放社交關係圖

停用項目

此變更適用於 7.0 版,並於 2020 年 8 月 3 日套用至所有版本。

粉絲專頁

應用程式範圍用戶編號

這些變更適用於 7.0 以上版本,並於 2021 年 5 月 5 日套用至所有版本。

2018 年 5 月 1 日起,粉絲專頁 API 開始為所有新應用程式傳回粉絲專頁範圍用戶編號(PSID),而不是應用程式範圍用戶編號(ASID)。在此日期之前建立的應用程式除非已選擇接收 PSID,否則會繼續接收 ASID。所有應用程式現在都會從粉絲專頁 API 接收 PSID。

粉絲專頁範圍編號 API 允許您將 ASID 對應至其 PSID 對等項目。API 在 7.0 以上版本中已停用,但在 2021 年 5 月 5 日之前仍可搭配舊版本使用。

停用項目

這些變更適用於 7.0 以上版本,並於 2020 年 8 月 3 日套用至所有版本。

以下端點已停用:

權限

manage_pages 權限已停用,並更換為 4 個新權限:

publish_pages 權限已停用,並更換為 2 個新權限:

已獲得 manage_pagespublish_pages(或以上兩者)許可的應用程式,將在 2020 年 6 月 1 日之前移轉到新權限。

對於已提交但尚未審查 manage_pagespublish_pages(或以上兩者)的應用程式,審查程序將照常進行。一旦通過審查,應用程式將會在 2020 年 6 月 1 日之前移轉到新權限。

若要在 2020 年 6 月 1 日之前申請或重新提交粉絲專頁權限,請選擇您在應用程式主控板中看到的權限,manage_pagespublish_pages(或以上兩者),或選擇新權限。如有必要,您的應用程式將在 2020 年 6 月 1 日之前自動移轉到新權限。

2020 年 6 月 1 日之後,應用程式主控板中的應用程式審查 > 權限和功能選項將不再提供 manage_pagespublish_pages

manage_pagespublish_pages 權限將於 2022 年 5 月完全停用。您必須在此日期之前將變更套用至您的程式碼。

SDK

請瀏覽 iOS SDK 變更紀錄Android SDK 變更紀錄,瞭解即將針對這些 SDK 進行的重要變更。

用戶

停用項目

這些變更適用於 7.0 以上版本,並於 2020 年 8 月 3 日套用至所有版本。

以下端點已停用:

行銷 API

發佈日期:2020 年 5 月 5 日 | 有效期限:2021 年 3 月 3 日 | 部落格文章

廣告行銷活動

行銷活動預算最佳化

此變更適用於 7.0 以上版本。

對於特定的廣告行銷活動,您無法再同時設定 lifetime_budgetspend_cap。您只能選擇 lifetime_budget

行銷活動總經費分散在行銷活動的整個過程中。當您在行銷活動層級使用 lifetime_budget 時,已包含花費上限資訊,因此沒有理由再新增第二個花費上限。

您可以針對未使用行銷活動預算最佳化的行銷活動繼續使用 spend_cap

特殊廣告類別

此變更適用於 7.0 以上版本。

POST /act_<AD_ACCOUNT_ID>/campaigns 端點上的 special_ad_category 參數已停用,並更換為新的 special_ad_categories 參數。

新的 special_ad_categories必要參數,並接受陣列。如果您取得 special_ad_category 參數,它仍然會傳回字串,但您應該使用 GET /{campaign-id}?fields=special_ad_categories 來取回陣列。

如需詳細資訊,請參閱特殊廣告類別

進一步瞭解廣告說明中心:特殊廣告類別

停用項目

此變更適用於 7.0 以上版本。

budget_rebalance_flag 參數已停用。建議您改用行銷活動預算最佳化

Atlas 廣告行銷活動

停用項目

此變更適用於 7.0 以上版本。

  • GET /{atlas-ad-campaign-id}/cumulative_edited_date

商品目錄

停用項目

此變更適用於 7.0 以上版本。

POST /PRODUCT_CATALOG_ID 關係連線上的 cpas_parent_catalog_settings 參數已停用於第三方應用程式。