圖形 API 第 26.0 版和行銷 API 第 26.0 版隆重登場

2026年7月29日

圖形 API 第 26.0 版和行銷 API 第 26.0 版隆重登場

發佈者： Ayyad Farah, Manjari Jain

圖形 API 26.0 版和行銷 API 26.0 版包含新功能、停用項目和重大變更。請檢視下方重點內容，並前往 V26.0 變更紀錄查看完整的變更清單和詳細資訊。

重要日期和變更

圖形 API - 商務訂單管理：自 2026 年 7 月 29 日起，針對 v26.0 以上版本中受影響端點的呼叫將會遭到封鎖。這些端點將於 2026 年 10 月 27 日從所有其餘的圖形 API 版本中移除，之後呼叫會傳回錯誤。沒有替代 API 可用。
圖形 API - Rights Manager 擁有者欄位：自 2026 年 7 月 29 日的 v26.0 版本開始，系統會提供傳回 RightsHolderOwner 類型的替代欄位，且不會再傳回停用的擁有者欄位。在第 26.0 版推出後兩年內，第 25.0 版和更早版本的已停用欄位仍可使用。
圖形 API：舊版協定功能：自 2026 年 7 月 29 日起，26.0 版呼叫將會移除五種舊版行為。自 2026 年 10 月 27 日起，相同行為將套用於所有其餘支援的圖形 API 版本。
行銷 API - WhatsApp 動態廣告：自 2026 年 7 月 29 日起，版本 26.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 版本呼叫開始，建立或更新廣告組合時，story 值會在 messenger_positions 中被默默移除。這項停用決策適用於所有行銷 API 版本，包括不分版本呼叫，且自 2026 年 10 月 27 日起生效。
行銷 API - 票選活動廣告建立流程：自 2026 年 7 月 29 日的 v26.0 開始，建立票選活動廣告創意或變更廣告以使用票選活動的要求都會遭到拒絕。我們仍會支援未變更廣告創意的現有廣告更新。此停用適用於 2026 年 10 月 27 日的所有行銷 API 版本。
圖形 API 和行銷 API - 投遞估計值欄位：自 2026 年 7 月 29 日開始，daily_outcomes_curve、budget_guardrail 和 estimate_dau 回應欄位將會從 v26.0 呼叫中移除，並將於 2026 年 10 月 27 日從所有其他支援的版本中移除。沒有替代 API 可用。
圖形 API 版本停用：圖形 API 20.0 版已於 2026 年 9 月 24 日停用並移除。圖形 API 第 21.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 張圖卡。

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

淘汰項目與重大變更

圖形 API 和行銷 API：移除「投遞估計值」欄位

由於提供這些值的服務已停用，daily_outcomes_curve、budget_guardrail 和 estimate_dau 欄位將從「投遞估計值」端點回應中移除。自 2026 年 7 月 29 日的圖形 API 第 26.0 版和行銷 API 第 26.0 版起，系統將不會再回傳這些欄位。該項變更將於 2026 年 10 月 27 日套用至所有其餘支援的圖形 API 和行銷 API 版本。沒有替代 API 可用。

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

受影響的代表端點包括：

GET /{ad-account-id}/delivery_estimate - Ad account delivery estimates
GET /{adset-id}/delivery_estimate - Ad set delivery estimates

您可以在 V26.0 變更紀錄中查看完整的欄位和端點清單。

圖形 API：商務訂單管理 API 停用

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

直接在 Facebook 和 Instagram 體驗商店結帳的功能已完全停用。商務訂單管理 API 允許第三方平台列出訂單、查看訂單明細、管理出貨、處理取消、處理退款以及追蹤該結帳體驗的退貨。由於基礎商務訂單基礎架構即將停用，這些端點將停用。

開發人員應停止呼叫這些端點並移除相依性。沒有替代 API 可用。

受影響的代表端點包括：

GET /{commerce-order-id} - Order details
GET /{commerce-order-id}/items - 訂單明細項目
GET /{commerce-order-id}/payments - Order payments
GET /{commerce-order-id}/payment_transaction_details - Payment transaction details
GET /{commerce-order-id}/refunds - 訂單退款
GET /{commerce-order-id}/shipments - Order shipments
GET /{commerce-order-shipment-id}/items - 出貨單明細項目
GET /{commerce-return-id} - Return details
GET /{commerce-order-cancellation-id}/items - Cancellation line items
GET /{page-id}/commerce_orders - 依粉絲專頁列出訂單
GET /{commerce-merchant-settings-id}/commerce_orders - List orders by Commerce Merchant Settings
GET /{commerce-merchant-settings-id}/commerce_returns - 根據商務商家設定列出退貨清單
GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

47 個受影響端點的完整清單將於圖形 API 第 26.0 版變更紀錄中提供。

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

AudioVisualReferenceMatch 和 ImageReferenceMatch 上的 reference_owner 和 matched_reference_owner 欄位，以及 CopyrightOwnershipTransfer 上的 sending_rights_holder 和 receiving_rights_holder 欄位將停用。從圖形 API 第 26.0 版開始，傳回專屬 RightsHolderOwner 類型的替代欄位可供使用，以更準確地呈現 Rights Manager 使用的所有權模型，而已停用的欄位不會再於第 26.0 版和更新版本的回應中傳回。

這些停用的欄位在第 26.0 版推出後兩年內，仍會繼續在第 25.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} - Ownership transfer details

您可以在圖形 API 第 26.0 版變更紀錄中找到完整的欄位清單。

圖形 API：停用舊版協定功能

自 2026 年 7 月 29 日起，圖形 API 第 26.0 版和後續版本不再支援五種舊版通訊協定行為：pretty、debug、date_format、根 GET /?ids=... 要求，以及舊版 If-None-Match／ETag 處理。

這些行為即將停用，以簡化圖形 API 回應，並讓要求處理方式更加一致。

針對圖形 API v26.0 和更新版本：

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

自 2026 年 10 月 27 日起，這些變更將套用於所有其餘支援的圖形 API 版本。請檢閱執行期間要求紀錄和圖形 API 第 26.0 版變更紀錄，以瞭解移轉詳細資料。

停用新版粉絲專頁體驗的舊版粉絲專頁欄位（圖形 API 第 26.0 版）

開發人員部落格文章草稿。目標版本：圖形 API 第 26.0 版。變更類型：停用（90 天）。

摘要

針對新版粉絲專頁體驗頁面，五個舊版粉絲專頁節點欄位（current_location、genre、network、parking、start_info）和 auto_publish_page_info_updates 粉絲專頁設定將從圖形 API v26.0 起停用。系統已不再維護這些欄位，且不應該針對新版粉絲專頁體驗頁面存取這些欄位。

時間表

2026 年 7 月 29 日：這些欄位在新版粉絲專頁體驗的 v26.0 以上版本中已封鎖且設定已移除。
推出後約 90 天：相同的變更將套用至所有其餘版本。2026 年 10 月下旬的確切日期待確認。

變更項目

在 26.0 以上版本中，在新版粉絲專頁體驗頁面上要求這五個欄位中的任何一個都會傳回版本錯誤，且 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 設定。
檢查您的要求紀錄、用戶端整合和主控板，以便在新版粉絲專頁體驗頁面上使用這些欄位。
如需完整的最新清單，請參閱圖形 API v26.0 變更紀錄。

參考資料

粉絲專頁節點參考資料

行銷 API：住房、就業以及金融商品和服務行銷活動的高效速成+ 廣告受眾要求

自 2026 年 7 月 29 日起，若使用行銷 API v26.0，targeting_automation 內的 advantage_audience 參數將會自動預設為 1，以實現完全預設或放寬廣告受眾設定。針對受限制的廣告受眾設定，開發人員必須明確地將住房、就業或金融商品和服務特殊廣告類別的行銷活動中的 advantage_audience 設為 1 或 0。

上述行為僅適用於建立新廣告組合。更新現有廣告組合時，任何 API 版本皆不會顯示此行為。

這與在行銷 API 第 23.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 26.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 整合，並使用自動目的地選擇或其他相容的網站和應用程式行銷活動手動目的地。

在 2026 年 10 月 27 日，v26.0 發佈的 90 天後，此限制將適用於所有行銷 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 專屬變更不會影響廣告管理員。未知版本呼叫和對 26.0 版之前版本的呼叫，最初不會受到影響。在 2026 年 10 月 27 日，v26.0 發行的 90 天後，淘汰項目將適用於所有行銷 API 版本，包括未設定版本的呼叫。

行銷 API：票選活動廣告建立流程停用

自 2026 年 7 月 29 日的行銷 API 第 26.0 版起，在建立或更新廣告和廣告創意時，系統將不再支援票選活動元件。interactive_components_spec 下方的 poll_spec 欄位和 type 欄位的 "poll" 值將不再提供使用。

建立票選活動廣告創意或要求廣告使用票選活動的要求，皆會遭到駁回。未變更廣告創意的現有廣告更新（例如狀態、預算或排程變更）可以繼續刊登。

以下端點將受到影響：

開發人員應在廣告創意規格中移除票選活動相關欄位，並使用不含票選活動元件的廣告創意。對 26.0 版之前版本的呼叫和未知版本呼叫，最初不會受到影響。

在 2026 年 10 月 27 日，v26.0 發佈的 90 天後，此停用項目將適用於所有行銷 API 版本。

Meta 商業 SDK 第 26 版發佈

Meta Business SDK 第 26 版將在圖形 API 第 26 版發佈後不久發佈。此版本將包括相依性升級、轉換 API 參數建立工具整合、新的 API 功能，以及停用商務訂單管理 API 和多個舊版通訊協定功能。

商業 SDK 現已整合至開放原始碼的轉換 API 參數建立工具。您可以利用這項新的整合來改善轉換 API 整合的品質。主要功能：自動產生（由廣告主設定的偏好設定限制）並加強參數 fbc、fbp、event_source_url、referrer_url、client_ip_address，並針對支援的語言自動進行 PII 正規化／雜湊處理，請前往此處查看更多資訊。商務訂單管理 API（47 個端點）已完全停用且無替代方案。Instagram 探索動態消息廣告版位已移除，若指定此版位，系統將會回傳錯誤。Messenger 限時動態版位已在 messenger_positions 中無聲移除。WhatsApp 動態廣告獲得了新功能，包括身分識別規格、最多 10 張輪播圖卡和站外轉換最佳化。

在開放平台 SDK 為�� 2 年的淘汰時間表期間，請注意即將淘汰和停用的項目：