隆重推出 Graph API v26.0 和推廣 API v26.0

2026年7月29日

隆重推出 Graph API v26.0 和推廣 API v26.0

發佈者： Ayyad Farah, Manjari Jain

Graph API v26.0 和推廣 API v26.0 包含全新功能、停用項目和重大變更。請查看下方重點整理，並瀏覽 V26.0 變更記錄以了解所有變更項目和詳情。

重要日期和變更

Graph API—商務訂單管理：由 2026 年 7 月 29 日起，系統會封鎖對 v26.0 及更高版本受影響端點的呼叫。這些端點會於 2026 年 10 月 27 日從所有其他 Graph API 版本中移除，之後呼叫會傳回錯誤。沒有替代 API 可供使用。
Graph API—Rights Manager 擁有者欄位：由 2026 年 7 月 29 日 v26.0 起，系統會提供傳回 RightsHolderOwner 類型的替代欄位，並且不會再傳回已停用的擁有者欄位。v26.0 推出後兩年內，您仍可在 v25.0 及更早版本使用已停用的欄位。
Graph API—舊版通訊協定功能：由 2026 年 7 月 29 日起，v26.0 呼叫會移除 5 項舊版行為。由 2026 年 10 月 27 日起，所有其他受支援的 Graph API 版本都會套用相同的行為。
推廣 API - WhatsApp 動態廣告：由 2026 年 7 月 29 日起，v26.0 會加入更多身分、目標設定、優化設定和廣告創意功能。
推廣 API—住屋、就業及金融商品和服務宣傳活動的進階高效速成廣告受眾：自 2026 年 7 月 29 日 v26.0 起，受目標設定限制的新廣告組合或複製廣告組合必須明確將 advantage_audience 設為 1 或 0。預設或寬鬆設定會繼續將其預設為 1，且現有的廣告組合更新不會受到影響。
推廣 API - Instagram「探索」動態消息：由 2026 年 7 月 29 日 v26.0 起，此版位不再可用。開發人員應從其版位配置中移除「探索」頁面。
推廣 API：網站和應用程式宣傳活動的網站專屬目的地：由 2026 年 7 月 29 日 v26.0 起，如果宣傳活動使用「網站和應用程式」轉換位置，廣告便無法使用 applink_treatment 設為 web_only 的廣告創意。此限制將於 2026 年 10 月 27 日起適用於所有推廣 API 版本。
推廣 API—Messenger 限時動態：由 2026 年 7 月 29 日的 v26.0 呼叫開始，建立或更新廣告組合時，系統會從 messenger_positions 中移除 story 值，而不發出任何通知。此停用變更將於 2026 年 10 月 27 日起適用於所有推廣 API 版本，包括無版本呼叫。
推廣 API—投票活動廣告建立流程：由 2026 年 7 月 29 日的 v26.0 起，任何建立投票活動廣告創意或將廣告改為使用投票活動廣告創意的要求都會被拒。我們仍會繼續支援未有更改廣告創意的現有廣告更新。此停用變更將於 2026 年 10 月 27 日起適用於所有推廣 API 版本。
Graph API 和推廣 API—刊登情況預計值欄位：由 2026 年 7 月 29 日起，daily_outcomes_curve、budget_guardrail 和 estimate_dau 回應欄位會從 v26.0 呼叫中移除，並於 2026 年 10 月 27 日從所有其他受支援版本中移除。沒有替代 API 可供使用。
Graph API 版本停用項目：Graph API v20.0 版會於 2026 年 9 月 24 日起停用並移除。Graph API v21.0 會於 2027 年 1 月 21 日停用並移除。

一般更新項目

推廣 API：WhatsApp 動態廣告支援範圍已擴展

由 2026 年 7 月 29 日推出的推廣 API v26.0 起，WhatsApp 動態廣告支援更多身分、目標設定、優化設定和廣告創意功能。

WhatsApp 身分：第三方推廣 API 呼叫者必須在專為 WhatsApp 動態刊登而設的廣告創意中明確加入 wamo_whatsapp_identity_spec。這些來電者的 WhatsApp 身分不會自動預設。
未知年齡目標設定：若選擇了 WhatsApp 動態版位，且未有設定 user_age_unknown，此欄位便會預設為 true，即是該宣傳活動可接觸年齡不明的 WhatsApp 用戶。
優化設定：站外轉換的轉換優化設定適用於「銷售」、「開發潛在顧客」和「互動」目標。我們亦支援「連結頁面瀏覽次數」優化設定。
廣告創意格式：輪播廣告支援最多 10 張圖卡。

請參閱版位目標設定和基本目標設定文件以了解詳情。

停用項目及重大變更

Graph API 和推廣 API：移除「刊登預計值」欄位

由於提供這些值的服務已停用，系統即將從「刊登預計值」端點回應中移除 daily_outcomes_curve、budget_guardrail 和 estimate_dau 欄位。由 2026 年 7 月 29 日起，Graph API v26.0 和推廣 API v26.0 將不再傳回這些欄位。此變更將於 2026 年 10 月 27 日起適用於所有剩餘的受支援 Graph API 和推廣 API 版本。沒有替代 API 可供使用。

開發人員應在相應的移除日期之前，移除所有使用或參照這些欄位的內容。

部分受影響的端點包括以下項目：

GET /{ad-account-id}/delivery_estimate：廣告帳戶預計刊登成效
GET /{adset-id}/delivery_estimate：廣告組合預計刊登成效

您可在 v26.0 變更記錄中查看完整欄位和端點清單。

Graph API：商務訂單管理 API 即將停用

由 2026 年 7 月 29 日起，在 Graph API v26.0 及更新版本上呼叫這些端點的應用程式會被封鎖。我們將於 2026 年 10 月 27 日移除所有其他 Graph API 版本的端點，之後呼叫將會傳回錯誤。

商店的 Facebook 和 Instagram 直接結帳體驗現已全面停用。透過商務訂單管理 API，第三方平台可以為該結帳體驗製作訂單清單、查看訂單詳情、管理出貨、處理取消要求、處理退款、追蹤退貨。由於基礎商務訂單基礎架構即將停用，這些端點亦將停用。

開發人員應停止呼叫這些端點，並移除相應的相依項目。沒有替代 API 可供使用。

部分受影響的端點包括以下項目：

GET /{commerce-order-id}：訂單詳情
GET /{commerce-order-id}/items：訂單單行項目
GET /{commerce-order-id}/payments：訂單付款
GET /{commerce-order-id}/payment_transaction_details：付款交易詳情
GET /{commerce-order-id}/refunds：訂單退款
GET /{commerce-order-id}/shipments：訂單出貨
GET /{commerce-order-shipment-id}/items：出貨單明細項目
GET /{commerce-return-id}：退款詳情
GET /{commerce-order-cancellation-id}/items：取消明細項目
GET /{page-id}/commerce_orders：依專頁列出訂單
GET /{commerce-merchant-settings-id}/commerce_orders：依商務商家設定列出訂單
GET /{commerce-merchant-settings-id}/commerce_returns：依商務商家設定列出退貨商品資訊
GET /{commerce-merchant-settings-id}/tax_settings：稅項設定

您可在 Graph API v26.0 變更記錄中查看 47 個受影響端點的完整清單。

Graph API：Rights Manager 擁有者欄位已轉移至 RightsHolderOwner

AudioVisualReferenceMatch 和 ImageReferenceMatch 上的 reference_owner 和 matched_reference_owner 欄位，以及 CopyrightOwnershipTransfer 上的 sending_rights_holder 和 receiving_rights_holder 欄位即將停用。從 Graph API v26.0 開始，系統會提供傳回專屬 RightsHolderOwner 類型的替代欄位，以更準確地代表 Rights Manager 使用的所有權模式，而 v26.0 及更高版本的回應中將不再傳回已停用的欄位。

已停用欄位將在 v26.0 推出後兩年內繼續適用於 v25.0 及更早版本，之後將被移除。開發人員應在此兩年期內轉用替代欄位。

使用下列替換欄位：

使用 reference_owner_rh_owner 而非 reference_owner。
使用 matched_reference_owner_rh_owner 而非 matched_reference_owner。
使用 sending_rights_holder_owner 而非 sending_rights_holder。
使用 receiving_rights_holder_owner 而非 receiving_rights_holder。

部分受影響的端點包括以下項目：

GET /{audio-visual-reference-match-id}：參考相符項目詳細資料
GET /{image-reference-match-id}：圖像參考相符項目詳細資訊
GET /{copyright-ownership-transfer-id}：所有權轉移詳情

完整欄位清單將會在 Graph API v26.0 變更記錄中提供。

Graph API：停用舊版通訊協定功能

由 2026 年 7 月 29 日起，Graph API v26.0 及更高版本不再支援 5 項舊版通訊協定行為：pretty、debug、date_format、root GET /?ids=... 要求，以及舊版 If-None-Match／ETag 處理程序。

我們之所以會停用這些行為，是為了簡化 Graph API 回應，讓要求處理程序更加一致。

Graph API v26.0 及更新版本：

pretty 已略過，且 JSON 回應使用精簡格式。在用戶端工具或程式碼中設定 JSON 格式。
debug 已略過，且沒有加入偵錯回應封套。使用標準偵錯工具。debug_token 端點不會受到影響。
包含 date_format 的要求會傳回參數錯誤。請使用預設日期格式，並視需要在本機轉換值。
使用 GET /?ids=... 的根目錄要求會傳回參數錯誤。請使用每個物件的要求或受支援的批量處理。
If-None-Match 已略過。舊版 ETag 回應標題和 304 Not Modified 行為已被移除，且要求會傳回完整回應。

由 2026 年 10 月 27 日起，這些變更會套用至所有其他受支援的 Graph API 版本。請查看執行階段要求記錄和 Graph API v26.0 變更記錄，以了解轉移詳情。

停用新版專頁體驗的舊版專頁欄位（Graph API v26.0）

開發人員網誌文章草稿。目標版本：Graph API v26.0。變更類型：停用（90 天）。

概要

對於新版專頁體驗頁面，Graph API v26.0 起會停用 5 個舊版專頁節點欄位（current_location、genre、network、parking、start_info）和 auto_publish_page_info_updates 專頁設定。這些欄位已不再維護，因此不應該在新版專頁體驗中存取。

時間表

2026 年 7 月 29 日： 在 v26.0 及更新版本中，新版專頁體驗的相關欄位會被封鎖，且相關設定會被移除。
大約 90 天後：上述變更適用於所有其他版本。2026 年 10 月下旬的確��生效日期待定。

變動內容

在 v26.0 及更新版本中，若您在新版專頁體驗頁面要求取得這 5 個欄位的任何一個，系統會傳回版本錯誤，並且專頁設定回應不會再顯示 auto_publish_page_info_updates 設定。在更早版本中，行為會在 90 天轉移期結束後才會變更，而所有版本之後都會套用相同的變更。

受影響的端點：

GET /{page-id}?fields=current_location
GET /{page-id}?fields=genre
GET /{page-id}?fields=network
GET /{page-id}?fields=parking
GET /{page-id}?fields=start_info
GET /{page-id}?fields=settings：系統會從傳回的設定清單中移除 auto_publish_page_info_updates 設定

開發人員應採取的行動

請從您的專頁要求中移除這些欄位和 auto_publish_page_info_updates 設定。
請檢查您的要求記錄、用戶端整合工具和管理中心，以了解新版專頁體驗頁面上使用這些欄位的情況。
請參閱 Graph API v26.0 變更記錄，查看完整的最新清單。

參考資料

專頁節點參考資料

推廣 API：住屋、就業及金融商品和服務宣傳活動的進階高效速成廣告受眾要求

由 2026 年 7 月 29 日起，推廣 API v26.0 targeting_automation 中的 advantage_audience 參數將自動預設為 1，以實現完全預設或寬鬆的廣告受眾設定。若是受限廣告受眾設定，開發人員必須明確地將屬於「住屋、就業」或「金融商品和服務」特殊廣告類別的宣傳活動的 advantage_audience 設定為 1 或 0。

此行為僅適用於建立新廣告組合的情況。更新現有廣告組合時，任何 API 版本均不會出現此行為。

這項操作方式與推廣 API v23.0 版中為特殊廣告類別以外的宣傳活動所推出的操作方式相同。詳情請參閱進階高效速成廣告受眾解決疑難文件。

下列 API 端點會受到影響：

POST /{ad-account-id}/adsets
POST /{adset-id}
POST /{adset-id}/copies

推廣 API：探索廣告版位功能已停用

由 2026 年 7 月 29 日起，推廣 API v26.0 會不再支援 Instagram「探索」動態消息版位。系統會停止在「探索」頁面刊登廣告，並且宣傳活動花費金額會自動轉移至其他合資格版位。

若嘗試建立或更新指定「探索」版位的廣告組合，系統將傳回錯誤。開發人員應從版位配置中移除「探索」，並使用其他符合資格的版位。

下列端點會受到影響：

POST /act_{ad-account-id}/adsets
POST /{ad-set-id}

推廣 API：網站和應用程式宣傳活動的網站專屬目的地功能停用

自 2026 年 7 月 29 日起，推廣 API v26.0 的開發人員將無法再於使用網站和應用程式轉換位置的宣傳活動中，為廣告附加 applink_treatment 已設為 web_only 的廣告創意。這會影響透過 POST /act_{ad-account-id}/ads 和 POST /{ad-id} 進行的廣告建立流程和更新。

廣告創意端點不會有變，但您需要在 POST /act_{ad-account-id}/adcreatives 配置 applink_treatment 值。開發人員應審視其 applink_treatment=web_only 整合工具，並使用自動選擇目的地功能，或是其他相容的手動選擇目的地功能，以推行網站和應用程式宣傳活動。

v26.0 發佈的 90 天後，即 2026 年 10 月 27 日，此限制將適用於所有推廣 API 版本。請參閱廣告和廣告創意文件以了解詳情。

推廣 API：Messenger 限時動態版位已停用

由 2026 年 7 月 29 日起，推廣 API v26.0 會不再支援透過 v26.0 或更新版本的呼叫來建立或更新廣告組合時，在 messenger_positions 中使用 story 值的功能。

對於這些呼叫，story 將從目標設定規格中悄悄移除，並且不會再出現在新廣告組合或現有廣告組合的有效版位中。透過 GET /{ad_set-id}?fields=targeting 要求的過往目標設定資料可能仍會包含 story。系統不會傳回專門的錯誤，但如果移除 story 後留下無��的版位配置，則可能會出現標準版位驗證錯誤。

下列端點會受到影響：

POST /act_{ad-account-id}/adsets
POST /{ad_set-id}

使用手動版位的開發人員應在 messenger_positions 移除 story。如果這是唯一的值，請移除整個 messenger_positions 欄位；如果沒有使用任何其他 Messenger 版位（例如 marketing_messages），也可以考慮從 publisher_platforms 中移除 messenger。您無需為進階高效速成版位採取任何動作。

此項僅限 API 的變更不會影響廣告管理員。無版本呼叫和 v26.0 之前版本的呼叫初期不會受到影響。在 v26.0 版本發佈 90 天後，即 2026 年 10 月 27 日，所有推廣 API 版本都會停用，包括無版本呼叫。

推廣 API：投票活動廣告建立流程已停用

由 2026 年 7 月 29 日推出的推廣 API v26.0 起，在建立或更新廣告及廣告創意時，系統將不再支援投票活動元件。interactive_components_spec 不再提供 poll_spec 欄位和 type 欄位的 "poll" 值。

任何要求建立投票活動廣告創意或將廣告設為使用投票活動的要求均會被拒。您仍可更新現有廣告的廣告創意以外的元素，例如更改狀態、預算或排定時間。

下列端點會受到影響：

開發人員應在其廣告創意規格中移除與投票活動相關的欄位，並使用不含投票活動元素的廣告創意。初期不會受到 v26.0 之前版本的呼叫和無版本呼叫所影響。

在 v26.0 發佈 90 天後，即 2026 年 10 月 27 日，此停用變更將適用於所有推廣 API 版本。

Meta Business SDK v26 版本

Meta Business SDK v26 將緊隨 Graph API v26 版本之後發佈。此版本將包含相依項目升級、轉換 API 參數建立工具整合程序、全新 API 功能，以及商務訂單管理 API 和多個舊版通訊協定的停用項目。

Business SDK 現已與開放原始碼轉換 API 參數建立工具整合。您可以運用這項新整合工具，來改善轉換 API 整合的品質。主要功能：自動產生（根據廣告客戶設定的偏好設定而定）和加強參數 fbc、fbp、event_source_url、referrer_url、client_ip_address，並為支援的語言提供自動 PII 正規化／雜湊處理功能。前往此處了解詳情。商務訂單管理 API（47 個端點）已全面停用，且不設替代方案。「Instagram 探索動態消息」廣告版位已被移除；若指定此版位，系統會傳回錯誤。Messenger 限時動態版位已在 messenger_positions 默默移除。WhatsApp 動態廣告現已推出多項新功能，包括身分規格、最多 10 張輪播圖卡，以及站外轉換優化設定。

根據我們平台 SDK 的 2 年停用計劃，接下來的停用和棄用項目如下：