11.0 版本

Graph API

發佈日期：2021 年 6 月 8 日 | 停用日期：2023 年 9 月 14 日 | 網誌文章

消費者應用程式

存取權限級別

適用於所有版本。

在未來幾週，存取級別將適用於所有現有消費者應用程式。對於這類應用，已經應用程式審查程序獲得批准的權限和功能將自動獲准使用進階存取權限。所有其他權限和功能則自動獲准使用標準存取權限。

在未來幾週，存取級別也將適用於所有新建立的應用程式。新建立應用程式將自動獲准電郵和 public_profile 權限的進階存取權限。然而，這兩種權限在預設情況下都會設定為標準存取權限，您必須手動設定為進階存取權限，才能向在應用程式中無角色的用戶要求這些權限。

開發人員支援

我們已發佈 Facebook for Business Status 工具，用於監察平台和商業產品（如廣告管理員、WhatsApp Business 和 Facebook 開發人員平台）的運行狀況。

Facebook 分析工具

停用項目

適用於所有版本。

Facebook 分析工具將於 2021 年 6 月 30 日起停用。此外，我們將停用推廣 API 的應用程式管理中心附加程式。如需了解詳情，請瀏覽企業商家幫助中心。

以下「應用程式節點」欄位已無法使用：

• analytics_config
• analytics_platform_metrics_config
• permissible_ad_accounts

以下端點已無法使用：

• GET Application/analytics_cohort_query
• GET Application/analytics_entity_user_config
• GET Application/analytics_event_types
• GET Application/analytics_funnel_query
• GET Application/analytics_query
• GET Application/analytics_segments

Instagram 基本顯示 API

存取憑證除錯工具

適用於所有版本。

存取憑證偵錯工具現時僅在檢查憑證錯誤時傳回應用程式範圍編號。

API 版本控制

適用於所有版本。

API 現在支援設定版本編號的呼叫。如要查詢指定 API 版本，請在查詢路徑中於基本網址後加入版本編號。例如：

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

系統會將不限版本的要求（缺少版本編號）解析為呼叫應用程式的應用程式管理中心 > 設定 > 進階 > 升級 API 版本設定中指定的版本。

應用程式範圍用戶編號

適用於 v11.0 版及以上版本。

新版本中已引入應用程式範圍用戶編號 (ASID)。大約兩年後，v10.0 版本將停用，ASID 將取代原始用戶編號，因此我們建議您開始將應用程式用戶的原始編號對應到其等效的 ASID。

• 所有版本都支援基於原始用戶編號的查詢。
• 僅 v11.0 及以上版本的呼叫支援基於 ASID 的查詢。
• v11.0 及以上版本的呼叫將在回應中收到 ASID，即使在查詢原始用戶編號時也是如此。

基於時間的分頁

適用於 v11.0 版及以上版本。

已向 GET /{user-id}/media 端點加入 since 和 until 參數，以支援基於時間的分頁。

Instagram Graph API

讚好數目

適用於 v11.0 及更新版本。將從 2021 年 9 月 7 日起適用於所有版本。

如果透過另一個端點或欄位擴充間接查詢 Instagram 媒體，系統會在媒體擁有者隱藏讚好數目時於 API 回應中略去 like_count 欄位。若是直接查詢 Instagram 媒體（只能由 Instagram 媒體擁有者提出），即使媒體的讚好數目已經隱藏，系統仍會傳回實際的讚好數目。

按時間分頁

適用於 11.0 版及以上版本。

已向 GET /{ig-user-id}/media 端點加入 since 和 until 參數，以支援基於時間的分頁。

即時體驗

範本

適用於 v11.0 及以上版本。

即時體驗範本測試已結束，現在可供所有開發人員使用。

Messenger 平台

訊息 postback Webhook

適用於 v11.0 及以上版本。

mid 欄位已新增至 messaging_postbacks Webhook，以允許應用程式獲取訊息編號。

停用航班資訊範本

適用於 v11.0 及以上版本。將從 2021 年 12 月 6 日起適用於所有版本。

無法呼叫包含任何航班資訊範本（airline_boardingpass、airline_checkin、airline_itinerary 和 airline_update 類型的 template_type）的 POST /{page-id}/messages。

oEmbed

新版 oEmbed Read 功能

適用於所有版本。

oEmbed 產品已由新版 oEmbed Read 功能取代。如果您在 2021 年 6 月 8 日之前實作 oEmbed 產品，則必須在 2021 年 9 月 7 日之前完成 oEmbed Read 功能的應用程式審查。如果您在 2021 年 9 月 7 日之前尚未獲准使用 oEmbed Read 功能，則您的 oEmbed 實作將無法載入。

專頁 API

留言編號

適用於 v11.0 及以上版本。將從 2021 年 9 月 7 日起適用於所有版本。

任何應用程式如果僅使用專頁公開內容存取功能查詢專頁端點，系統將不會傳回 id 留言欄位，包括 id 欄位 /PAGEPOST-ID/comments 或 /COMMENT-ID/comments。如需獲取專頁帖子上留言的 id 留言欄位，應用程式用戶必須能夠在查詢的專頁上執行MODERATE 任務。

新版專頁體驗

在未來數月，所有經典版專頁都將遷移至新版專頁體驗。您可使用 has_transitioned_to_new_page_experience 專頁欄位來確認專頁是否已遷移。所有專頁完成遷移後，經典版專頁體驗將無法再可用。

大多數專頁 API 端點都支援經典版專頁和 NPE 專頁。支援 NPE 專頁的端點會在其引用資料中顯示「新版專頁體驗」部分。

以下端點不支援 NPE 專頁：

• /PAGE-ID/likes
• /PAGE-ID/global_brand_children
• /PAGE-ID/locations
• /PAGE-ID/tabs
• /PAGE-ID/visitor_posts

NPE 無法使用多個專頁欄位，並且在呼叫這些欄位時將傳回 null、另一個資料集或錯誤。有關這些專頁欄位的清單，請瀏覽我們的新版專頁體驗概覽。

權限

user_likes

適用於所有版本。

已更新 user_likes 權限的允許的使用方式。自 2021 年 9 月 7 日起，已獲准使用此權限但違反新版使用說明的應用程式將被撤銷許可。

• 舊版允許的使用方式：有意義地提升用戶使用您應用程式時的體驗（必須讓用戶清楚了解您會如何使用其資料來提供相關體驗）。
• 新版允許的使用方式：透過關聯或呈現與用戶讚好相關的內容，提供個人化體驗。這包括大規模策劃內容，從而使用大量內容來制定個人化應用程式，以及允許用戶與他人分享自己讚好的內容，例如在約會交友和音樂應用程式中。

user_posts

適用於所有版本。

已更新 user_posts 權限的允許的使用方式。自 2021 年 9 月 7 日起，已獲准使用此權限但違反新版使用說明的應用程式將被撤銷許可。

• 舊版允許的使用方式：有意義地提升用戶使用您應用程式時的體驗（必須讓用戶清楚了解您會如何使用其資料來提供相關體驗）。
• 新版允許的使用方式：讓用戶使用其生活時報建立實體或電子書或相簿，並在 Facebook 或其他社交應用程式中分享生活時報中的回憶。

SDK

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

營銷 API

發佈日期：2021 年 6 月 8 日 | 停用日期：2022 年 2 月 23 日 | 網誌文章

廣告受眾

刪除自訂廣告受眾、類似廣告受眾和儲備廣告受眾

適用於所有版本。

自 2021 年 6 月 8 日起，兩年以上未在任何有效廣告組合中使用的自訂廣告受眾、類似廣告受眾或儲備廣告受眾均將標示為「即將到期的廣告受眾」。系統會安排在這些廣告受眾被標記為「即將到期的廣告受眾」的 90 天後將其刪除。

開發人員可使用 operation_status 欄位篩選「即將到期的廣告受眾」狀態，並使用 delete_time 欄位查看廣告受眾在系統中的預計刪除時間。開發人員可以選擇主動刪除廣告受眾，也可以在有效廣告組合中使用廣告受眾以免刪除。廣告受眾一旦刪除，廣告客戶將無法重新啟用相關廣告受眾。

自訂廣告受眾（顧客名單自訂廣告受眾除外）、類似廣告受眾或儲備廣告受眾：

• 如果廣告客戶希望自 2021 年 9 月 6 日起自動刪除標示的廣告受眾受眾，則無需採取任何行動。但是，如果廣告客戶希望在自動刪除日期之前主動刪除廣告受眾，也可以主動刪除。
• 如果廣告客戶希望保留的標示的廣告受眾，則應該計劃在 2021 年 9 月 6 日之前在有效的廣告組合中使用這些廣告受眾，以免刪除。

顧客名單自訂廣告受眾：

• 我們會根據廣告客戶的指示，代表他們儲存這些廣告受眾。如果廣告客戶在 2021 年 9 月 6 日之前未採取任何行動，沒有在有效的廣告組合中使用標示的廣告受眾，我們會將其視為可刪除標示廣告受眾的指示。

以下端點及欄位將受到影響：

• GET /{custom-audience-id}
• GET /act_{ad-account-id}/customaudiences?filtering
• GET /act_{ad-account-id}/saved_audiences?filtering
• GET /{saved-audience-id}

查看廣告受眾概覽：自訂廣告受眾刪除變更，以進一步了解這些更新。

企業 API

適用於所有版本。

我們將暫時限制用戶存取以下端點。只有在過去 30 天內成功呼叫這些端點的應用程式才能繼續存取這些下端點。

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

所有其他應用程式如果呼叫這些端點，均會收到錯誤訊息。

目錄 API

停用商品庫存欄位

適用於 11.0 及以上版本。

inventory 欄位將會停用，並以新的 quantity_to_sell_on_facebook 欄位取代。雖然我們在近期將繼續支援 inventory 欄位，但我們建議您改用新的 quantity_to_sell_on_facebook 欄位。

以下端點會受到影響：

• GET /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

請參閱商品銷售數量和支援的商品欄位 - 動態廣告和商務，以進一步了解此更新。

刪除非空白的商品群組

適用於 11.0 及以上版本。將從 2021 年 9 月 7 日起適用於所有版本。

我們不再預設支援刪除非空白的商品群組。您可以在刪除要求中套用 deletion_method=delete_items，以刪除非空白的商品群組。這會同時刪除商品群組及其商品。

以下端點會受到影響：

• DELETE /<product_group_id>

刪除直播商品系列

適用於 11.0 及以上版本。將從 2021 年 9 月 7 日起適用於所有版本。

我們不再預設支援刪除直播商品系列。如需刪除包含直播商品系列的目錄，請將目錄的 allow_delete_catalog_with_live_product_set 參數設定為 true。

這會影響下列端點：

• DELETE /<product_catalog_id>

全新診斷端點

適用於 11.0 版及以上版本。

我們已加入全新端點 GET /{product_catalog_id}/diagnostics。此端點可用於擷取指定目錄的診斷資料，例如阻止商品在渠道中顯示的問題，以及提升商品曝光度的機會。

商務 API

訂單總額預估付款詳情

適用於 11.0 及以上版本。將從 2021 年 9 月 7 日起適用於所有版本。

我們正在更改呼叫 {commerce-order-id}/?fields=estimated_payment_details 端點的訂單總額中報告預估付款詳情的方式。在此之前，系統會為尚未完成的訂單使用預估稅項，為已完成的訂單使用已完成稅項。從 11.0 版本開始，此端點將始終使用預估稅項。請注意，您可以使用 {commerce-order-id}/items?fields=tax_details 來存取有關已完成稅項的詳細資訊。

轉換提升

衡量數據變更

適用於 v11.0 及以上版本。將從 2021 年 9 月 7 日起適用於所有版本。

從 GET /{objective-id}/?fields=result 欄位傳回的衡量數據現已變更。

以下衡量數據現已新增：

• conversions_incremental_share
• conversions_CPiC
• conversions_multicell_confidence
• conversions_multicell_rank
• sales_incremental_share
• sales_multicell_confidence
• sales_multicell_rank
• buyers_incremental_share
• buyers_CPiB
• buyers_multicell_confidence
• buyers_multicell_rank

以下衡量數據現已移除：

• advancedBuyers.control
• ancedBuyers.informativeMultiCellBayesianConfidence
• advancedBuyers.lift
• advancedBuyers.test
• advancedConversions.control
• advancedConversions.informativeMultiCellBayesianConfidence
• advancedConversions.lift
• advancedConversions.test
• advancedSales.control
• advancedSales.informativeMultiCellBayesianConfidence
• advancedSales.lift
• advancedSales.test
• buyers.baseline
• buyers.bayesianCILower
• buyers.bayesianCIUpper
• buyers.control
• buyers.delta
• buyers.incremental
• buyers.isStatSig
• buyers.lift
• buyers.multiCellBayesianConfidence
• buyers.reachedPercent
• buyers.singleCellBayesianConfidence
• conversions.baseline
• conversions.bayesianCILower
• conversions.bayesianCIUpper
• conversions.control
• conversions.delta
• conversions.incremental
• conversions.isStatSig
• conversions.lift
• conversions.multiCellBayesianConfidence
• conversions.reachedPercent
• conversions.singleCellBayesianConfidence
• frequency
• incrementalROAS
• sales.baseline
• sales.bayesianCILower
• sales.bayesianCIUpper
• sales.control
• sales.delta
• sales.incremental
• sales.isStatSig
• sales.lift
• sales.multiCellBayesianConfidence
• sales.singleCellBayesianConfidence

以下衡量數據現已重新命名：

您可在 Facebook 提升幅度衡量數據詞彙表中查看可用衡量數據的完整清單。

洞察報告 API

停用來店客流量衡量數據

適用於 11.0 及以上版本。將從 2021 年 9 月 6 日起適用於所有版本。

已停用 store_visits_actions 和 cost_per_store_visit_actions。

以下端點會受到影響：

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

優惠廣告 API

停用優惠廣告 API 端點

適用於 v11.0 及以上版本。將從 2021 年 9 月 7 日起適用於所有版本。

Facebook 致力於不斷提高產品的穩定性，作為其中的一項措施，我們將於 2021 年 6 月 8 日停止支援優惠廣告產品。我們建議您改用標準版 Facebook 廣告來發佈店內和／或網上折扣。至於折扣資訊、兌換地點、過期日期和推廣碼，我們則建議您直接放在廣告級別的廣告創意中。

以下端點會停用：

• GET /{page-id}/nativeoffers
• POST /[page-id}/nativeoffers
• GET /pagename/nativeoffers
• GET /{native-offer-id}
• GET /{native-offer-id}/views
• POST /{native-offer-id}/codes
• POST /{native-offer-id}/nativeofferviews
• GET /{offer-id}/comments
• GET /{offer-id}/sharedposts
• GET /{offer-id}/likes