第 11.0 版

圖形 API

發佈日期：2021 年 6 月 8 日 | 有效期限：2023 年 9 月 14 日 | 部落格文章

消費者應用程式

存取權限層級

適用於所有版本。

在未來幾週，存取層級將適用於任何現有的消費者應用程式。針對這些應用程式，已通過應用程式檢閱程序核可的權限和功能，將自動獲得進階存取的核可。所有其他權限和功能將自動獲得標準存取的核可。

存取層級也將在未來幾週適用於所有新建立的應用程式。新建立的應用程式將自動獲得電子郵件和 public_profile 權限的進階存取核可。不過，這兩個權限預設將設為標準存取，必須先手動設為進階存取，才可供不具應用程式角色的應用程式用戶提出要求。

開發人員支援

我們已發佈 Facebook for Business 狀態工具，可用來監控平台和 Business 產品（例如廣告管理員、WhatsApp Business 和 Facebook 開發人員平台）的健康狀態。

Facebook 分析工具

淘汰項目

適用於所有版本。

2021 年 6 月 30 日後，Facebook 分析工具將無法再使用。此外，我們正逐漸停用行銷 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 版本設定中指定的版本。

應用程式範圍用戶編號

適用於 11.0 以上版本。

我們已推出應用程式範圍用戶編號（ASID）。當 10.0 版停用時，ASID 將在大約兩年內取代原始用戶編號，因此建議您開始將應用程式用戶對應到其等同的 ASID。

• 所有版本都支援原始用戶編號型查詢。
• 只有 11.0 以上版本呼叫支援 ASID 型查詢。
• 即使查詢的是原始用戶編號，11.0 以上版本的呼叫在回應中也將收到 ASID。

時間型分頁

適用於 11.0 以上版本。

已在 GET /{user-id}/media 端點中新增 since 和 until 參數來支援時間型分頁。

Instagram 圖形 API

按讚數

適用於 11.0 以上版本，將於 2021 年 9 月 7 日套用至所有版本。

如果透過另一個端點或欄位擴充功能間接查詢 IG 影音內容，當影音內容擁有者已隱藏按讚數時，系統將會省略 API 回應中的 like_count 欄位。不過，即使已隱藏影音內容的按讚數，直接查詢 IG 影音內容（只能由 IG 影音內容擁有者執行）仍會傳回實際按讚數。

時間型分頁

適用於 11.0 以上版本。

已在 GET /{ig-user-id}/media 端點中新增 since 和 until 參數來支援時間型分頁。

即時體驗

範本

適用於 11.0 以上版本。

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

Messenger 開放平台

訊息回傳 Webhook

適用於 11.0 以上版本。

系統已將 mid 欄位加入 messaging_postbacks Webhook，讓應用程式可以取得訊息編號。

停用航空公司範本

適用於 11.0 以上版本，將於 2021 年 12 月 6 日套用至所有版本。

針對包括任何航空公司範本（airline_boardingpass、airline_checkin、airline_itinerary、airline_update 類型的 template_type）的 POST /{page-id}/messages 所發出的呼叫都將失敗。

oEmbed

oEmbed 讀取新功能

適用於所有版本。

oEmbed 產品已由 oEmbed 讀取新功能所取代。如果您在 2021 年 6 月 8 日之前實作 oEmbed 產品，則必須在 2021 年 9 月 7 日之前完成 oEmbed 讀取功能的應用程式檢閱。如果您在 2021 年 9 月 7 日之前尚未獲得 oEmbed 讀取功能的核可，您的 oEmbed 實作將無法載入。

粉絲專頁 API

留言編號

適用於 11.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 來存取已履行稅金的詳細資料。

轉換提升

衡量指標變更

適用於 11.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 端點

適用於 11.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