版本 7.0

Graph API

發佈日期：2020 年 5 月 5 日 | 停用日期：2022 年 8 月 4 日 | 網誌文章

Facebook Business 擴充功能 v2

此變更適用於所有版本。

Facebook Business 擴充功能 v2 加入兩個新欄位。

• 廣告帳戶編號（ad_account_id）— 代表用戶在 Facebook Business 擴充功能內選擇的廣告帳戶編號。如果您的應用程式具有 ads_management 權限，此廣告帳戶便可用於管理廣告。

• 目錄編號（catalog_id）— 用戶在 Facebook Business 擴充功能內選擇的目錄編號。此編號可用於管理商品目錄。

Instagram

主題標籤搜尋

此變更適用於 v7.0 及以上版本。

您現可透過 GET /{ig-hashtag-id}/top_media 和 GET /{ig-hashtag-id}/recent_media主題標籤搜尋的查詢，就傳回的 Instagram 媒體要求 timestamp 欄位。例如：GET /{ig-hashtag-id}/top_media?fields=timestamp。

Messenger

顧客洽談附加程式

此變更適用於 v7.0 及以上版本，並於 2020 年 11 月 2 日起適用於所有版本。

透過顧客洽談附加程式開始新對話或繼續現有對話時，初始的 messaging_postbacks 和 messaging_referrals Webhook 通知會包含用戶的匿名 user_ref 編號，而不是用戶的專頁範圍編號（PSID）。在用戶傳送訊息後，後續 Webhook 通知會包含該用戶的 PSID。

專頁 Messenger 個人檔案

此變更適用於 v7.0 及以上版本。

對於所有操作（GET、POST 和 DELETE）而言，專頁 Messenger 個人檔案的 home_url 屬性已停用。

開放式圖表

停用

此變更適用於 v7.0 及以上版本，並於 2020 年 8 月 3 日起適用於所有版本。

• GET /{open-graph-action-type-id}
• POST /{user-id}/{open-graph-action-type-id}

專頁

應用程式範圍用戶編號

此等變更適用於 7.0 及以上版本，並於 2021 年 5 月 5 日起適用於所有版本。

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

透過專頁專屬編號 API，您可以將 ASID 對應至其相應 PSID。此 API 已在 v7.0 版及以上版本停用，但在 2021 年 5 月 5 日之前仍可與舊版本配合使用。

停用

此等變更適用於 v7.0 及以上版本，並於 2020 年 8 月 3 日起適用於所有版本。

以下端點已停用：

• GET /{page-id}/featured_videos_collection
• POST /{page-id}/albums

權限

manage_pages 權限已停用，並由以下 4 項新權限取代：

• pages_manage_ads
• pages_manage_metadata
• pages_read_engagement
• pages_read_user_content

publish_pages 權限已停用，並由以下 2 項新權限取代：

• pages_manage_posts
• pages_manage_engagement

如果應用程式已獲得 manage_pages 和／或 publish_pages 權限授權，我們會在 2020 年 6 月 1 日前將該應用程式轉移至新權限。

如果應用程式已要求 manage_pages 和／或 publish_pages 權限但經審查，則審查程序會繼續如常進行。在應用程式獲得授權後，我們會在 2020 年 6 月 1 日前將其轉移至新權限。

如要在 2020 年 6 月 1 日前申請或重新要求專頁權限，請選擇您在應用程式管理中心內看到的權限：manage_pages 和／或 publish_pages 的權限，或者新的權限。如有必要，系統會在 2020 年 6 月 1 日前自動將您的應用程式轉移至新權限。

2020 年 6 月 1 日後，應用程式管理中心的應用程式審查 > 權限和功能選項中將不再有 manage_pages 和 publish_pages。

manage_pages 和 publish_pages 權限於 2022 年 5 月完全停用。如要變更程式碼，請務必在此日期前套用變更。

SDK

請瀏覽 iOS SDK 變更記錄和 Android SDK 變更記錄，了解即將對這些 SDK 作出的重大變更。

用戶

停用

此等變更適用於 v7.0 及以上版本，並於 2020 年 8 月 3 日起適用於所有版本。

以下端點已停用：

• GET /{user-id}/books
• GET /{user-id}/games
• GET /{user-id}/movies
• GET /{user-id}/television

推廣 API

發佈日期：2020 年 5 月 5 日 | 停用日期：2021 年 3 月 3 日 | 網誌文章

廣告宣傳活動

宣傳活動預算優化

此變更適用於 v7.0 及以上版本。

您無法再為指定宣傳活動同時設定 lifetime_budget 和 spend_cap，只可選擇 lifetime_budget。

宣傳活動總經費會在整個宣傳活動過程攤分。您在宣傳活動層級使用 lifetime_budget 時，當中已包含花費上限資訊，因此您無需再新增另一個花費上限。

如果宣傳活動沒有使用宣傳活動預算優化，則您仍然可以使用 spend_cap。

特殊廣告類別

此變更適用於 v7.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，方能傳回陣列。

詳情請參閱特殊廣告類別。

詳情請參閱廣告幫助中心 > 特殊廣告類別。

停用

此變更適用於 v7.0 及以上版本。

budget_rebalance_flag 參數已停用。建議您改用宣傳活動預算優化。

Atlas 宣傳活動

停用

此變更適用於 v7.0 及以上版本。

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

商品目錄

停用

此變更適用於 v7.0 及以上版本。

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