主頁
網誌
隆重推出 Graph API v25.0 和推廣 API v25.0

2026年2月18日

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

發佈者： Manjari Jain

查閱下文，了解在 V25 版本之下 Graph API 和推廣 API 的全新變更，掌握重點。請瀏覽我們的變更記錄，以取得有關變更和詳情的完整清單。

一般更新

Graph API：推出「專頁檢視者人數」衡量數據

我們計劃於 2026 年 6 月底在 Graph API 中推出「專頁檢視者人數」衡量數據。「檢視者人數」衡量數據旨在取代舊有的「接觸人數」衡量數據，就 Facebook 和 Instagram 提供跨平台一致的成效衡量體驗，以便您了解有多少用戶看過某則內容。開發人員應開始規劃以準備轉用檢視者衡量數據，確保之後能繼續存取廣告受眾洞察報告。

有何變更？

專頁洞察報告和限時動態洞察報告將提供「檢視者人數」衡量數據

帖子／專頁洞察報告

  • GET {page-id}/insights/page_total_media_view_unique*
  • GET {post-id}/insights/post_total_media_view_unique*

限時動態洞察報告

  • 將加入新的衡量數據
  • GET {stories-id}/insights/metric
    • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

上述 Graph API 會在 V25 版本發佈後開放使用。建議開發人員查看 Graph API 變更記錄，以取得最新資訊。

Webhooks mTLS 憑證更新

自 2026 年 3 月 31 日起，Meta 會開始使用自有的另一個認證機構（CA）來簽署 Webhooks mTLS 憑證。

這對開發人員有何影響？

如果您的伺服器配置為要求和驗證 Webhooks mTLS 憑證，則您必須信任新的 Meta CA。如果您未能在截止日期之前更新信任存放區，將會導致 TLS 交握失敗，而且您的伺服器將停止接收所有 Webhooks 事件。

需要採取行動：更新信任存放區

為確保順利接收 Webhooks，您必須執行以下操作：

  1. 下載 Meta 根 CA 證書：前往「Webhooks 新手指南」，然後下載名為「meta-outbound-api-ca-2025-12.pem」的檔案。
    根 CA 將簽署在 Webhooks 要求中顯示的分葉證書。
  2. 將此加入信任存放區中：將此憑證加入任何接收 Webhooks 的伺服器之信任存放區中。
  3. 保留現有憑證：您應在現有憑證仍未過期時，將新憑證加入信任存放區中。

重要事項：請勿等到最後期限才行動。您應立即將新憑證加入信任存放區中，以確保在 3 月 31 日能夠順利過渡。

最後期限：2026 年 3 月 31 日前。

推出此變更的原因

目前的 Webhooks mTLS 憑證由 DigiCert 根 CA 簽署。由於 DigiCert 將停用用戶端驗證 EKU，因此在 2025 年 4 月 15 日此根 CA 到期後，憑證便無法更新。

有見及此，新的 Webhooks mTLS 憑證將由 Meta 內部根 CA 簽署。新憑證將沿用現有憑證的常用名稱（client.webhooks.fbclientcerts.com）。

關於 Webhooks mTLS 的公開文件已更新，並附上有關此變更的通知。過渡期結束後，我們將於 2026 年 4 月永久更新文件中的完整技術詳情。

停用項目及重大變更

改善廣告洞察報告非同步 API 的錯誤訊息

我們一直致力改善開發人員的 API 體驗。為提高透明度，讓開發人員能夠建立更靈活應變的應用程式，我們現加強廣告洞察報告非同步 API GET {AD_REPORT_RUN_ID} 端點的錯誤回報功能。

由我們在 2026 年 2 月 18 日發佈下一個 Graph API 版本 V25.0 起，開發人員可以在非同步報告失敗時存取詳細的錯誤資訊，以便更輕鬆地診斷失敗情況，同時提高其 API 整合的效率。若開發人員現時可存取 error_code 欄位，該類型將從 uint 變更為 int。

有何變更？

我們將為所有應用程式的廣告洞察報告非同步 API GET {AD_REPORT_RUN_ID} 端點，在回應中加入下列新的預設欄位：

  • error_code：錯誤代碼。備註：系統會為任何目前有權存取此欄位的開發人員，將 uint 改為 int。
  • error_message：與 error_code 相應的訊息。
  • error_subcode：相關錯誤的特定子代碼。
  • error_user_title：方便用戶理解的錯誤子代碼標題。
  • error_user_msg：方便用戶理解的訊息，當中詳細說明錯誤子代碼。

系統會在報告執行失敗時，在這些欄位填入資料。我們建議您檢查自己的 API 整合，以確保其與回應中的新預設欄位相容。

此更新預計隨下一個 Graph API 版本發佈。建議開發人員查閱 Graph API 變更記錄，以取得最新資訊。開發人員文件亦已更新，以反映此等變更。

Graph API：停用中繼資料查詢參數

由 Graph API v25 開始，我們會停用 metadata=1 查詢參數。此參數之前用於在 API 回應中傳回有關節點欄位和連結的中繼資料。此功能的使用率低，因此我們將停用此功能以簡化平台。停用後，API 要求將略過 metadata 參數。

目前依靠 metadata=1 的開發人員應改用我們的官方 API 文件，以探索每種節點類型的可用欄位和連結。

有何變更？

變更

時間表

停用 metadata=1 查詢參數

v25（2026 年 2 月）

移除 metadata=1 查詢參數

2026 年 5 月

變更前（v24 及更舊版本）：

在 Graph API 要求中加入 ?metadata=1 後，系統將就節點傳回額外中繼資料，包括可用欄位和連結。

變更後（v25 及更新版本）：

系統會略過 metadata=1 參數。對於包含此參數的要求，系統將繼續傳回不包含中繼資料的標準回應。不會發生任何失敗或重大變更：如果您的要求包含 metadata=1，將不會導致錯誤或服務中斷；這個參數單純只是無法生效。

Graph API：停用「專頁接觸人數」／「展示次數」衡量數據

我們計劃在 2026 年 6 月停用 Graph API 中以下衡量數據：帖子／專頁接觸人數、影片展示次數，以及限時動態展示次數。這些舊版衡量數據不會再出現在我們的洞察報告工具中，但在此之前仍可透過 API 取得。

為了就我們各項產品和 API 統一採用單一且一貫的衡量數據架構，並且提高整體系統可靠度，我們將停用這些舊版衡量數據。停用後，開發人員應轉用全新的「影音內容檢視次數」和「影音內容檢視者人數」衡量數據，以取代舊有的「展示次數」、「接觸人數」和「影片觀眾人數」概念。

有何變更？

下列衡量數據將於 2026 年 6 月起在所有 API 版本停用。建議開發人員查閱 Graph API 變更記錄，以取得最新資訊：

帖子／專頁接觸人數

  • GET {page-id}/insights/page_impressions_unique*
  • GET {page-id}/insights/page_impressions_paid_unique*
  • GET {page-id}/insights/page_impressions_viral_unique*
  • GET {page-id}/insights/page_impressions_nonviral_unique*
  • GET {page-id}/insights/page_posts_impressions*
  • GET {page-id}/insights/page_posts_impressions_unique*
  • GET {page-id}/insights/page_posts_impressions_paid*
  • GET {page-id}/insights/page_posts_impressions_paid_unique*
  • GET {page-id}/insights/page_posts_impressions_organic_unique*
  • GET {page-id}/insights/page_posts_served_impressions_organic_unique*
  • GET {page-id}/insights/page_posts_impressions_viral*
  • GET {page-id}/insights/page_posts_impressions_viral_unique*
  • GET {page-id}/insights/page_posts_impressions_nonviral*
  • GET {page-id}/insights/page_posts_impressions_nonviral_unique*
  • GET {post-id}/insights/post_impressions_unique*
  • GET {post-id}/insights/post_impressions_paid_unique*
  • GET {post-id}/insights/post_impressions_fan_unique*
  • GET {post-id}/insights/post_impressions_organic_unique*
  • GET {post-id}/insights/post_impressions_viral_unique*
  • GET {post-id}/insights/post_impressions_nonviral_unique*
  • GET {post-id}/insights/post_impressions_nonviral_unique*

影片展示次數

  • GET {video-id}/video_insights/post_impressions_unique
  • GET {video-id}/video_insights/total_video_impressions
  • GET {video-id}/video_insights/total_video_impressions_unique
  • GET {video-id}/video_insights/total_video_impressions_paid_unique
  • GET {video-id}/video_insights/total_video_impressions_paid
  • GET {video-id}/video_insights/total_video_impressions_organic_unique
  • GET {video-id}/video_insights/total_video_impressions_organic
  • GET {video-id}/video_insights/total_video_impressions_viral_unique
  • GET {video-id}/video_insights/total_video_impressions_viral
  • GET {video-id}/video_insights/total_video_impressions_fan_unique
  • GET {video-id}/video_insights/total_video_impressions_fan
  • GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
  • GET {video-id}/video_insights/total_video_impressions_fan_paid

限時動態展示次數

  • 將替換兩項衡量數據
  • GET {stories-id}/insights/metric
    • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
    • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

建議改用以下衡量數據：

  • GET {page-id}/insights/page_total_media_view_unique
  • GET {post-id}/insights/post_total_media_view_unique

下列衡量數據提供的分析資料與原有洞察報告十分類似，因此特別建議在查詢付費與自主「接觸人數」的資料細節時使用：

  • GET {page-id}/insights/page_media_view
  • GET {post-id}/insights/post_media_view

Graph API：停用「觀看影片 3 秒以上的觀眾人數」衡量數據

我們計劃於 2026 年 6 月停用「觀看影片 3 秒以上的觀眾人數」衡量數據。這些舊版衡量數據不會再出現在我們的洞察報告工具中，但在此之前仍可透過 Graph API 取得。

為了就我們各項產品和 API 統一採用單一且一貫的衡量數據架構，並且提高整體系統可靠度，我們將停用這些舊版衡量數據。停用後，開發人員應轉用全新的「影音內容檢視次數」和「影音內容檢視者人數」衡量數據，以取代舊有的「展示次數」、「接觸人數」和「影片觀眾人數」概念。

有何變更？

下列衡量數據將於 2026 年 6 月起在所有 API 版本停用。建議開發人員查閱 Graph API 變更記錄，以取得最新資訊：

  • GET {page-id}/insights/page_video_views_unique
  • GET {post-id}/insights/post_video_views_organic_unique
  • GET {post-id}/insights/post_video_views_paid_unique
  • GET {post-id}/insights/post_video_views_unique
  • GET {video-id}/video_insights/total_video_views_organic_unique
  • GET {video-id}/video_insights/total_video_views_paid_unique
  • GET {video-id}/video_insights/total_video_views_unique

建議改用以下衡量數據：

  • GET {page-id}/insights/page_total_media_view_unique
  • GET {post-id}/insights/post_total_media_view_unique

下列衡量數據提供的分析資料與原有洞察報告十分類似，因此特別建議在查詢付費與自主「觀看影片 3 秒以上的觀眾人數」的資料細節時使用：

  • GET {page-id}/insights/page_media_view
  • GET {post-id}/insights/post_media_view

推廣 API：停用 ASC 和 AAC

自動化統一功能可將應用程式、銷售和開發潛在顧客宣傳活動的設定，預設為最理想和以自動化為先的進階高效速成設定，讓廣告客戶和合作夥伴更簡便地使用 Meta 最新且效果最佳的自動化產品。我們正在逐步為推廣 API 開發人員停用舊版 API，並轉為全新的自動化統一進階高效速成設定。

由 2026 年 2 月 18 日推出的 V25.0 版本起，您無法再使用推廣 API 建立或更新 ASC 和 AAC 宣傳活動；90 天後，即 2026 年 5 月 19 日起，所有推廣 API 版本都會受到此變更的影響。

在預計於 2026 年 9 月推出的 V26.0 版本後，所有剩餘的 ASC 和 AAC 宣傳活動都將暫停。

若 ASC 或 AAC 宣傳活動採用「現有顧客預算上限」（ECBC），則在 V26.0 版本推出前仍可供編輯；此功能不適用於進階高效速成宣傳活動。若開發人員有 ECBC 宣傳活動，則應採取以下其中一種方法，於 V26.0 版本推出前複製有關宣傳活動：

  • 手動建立副本：在廣告管理員中開啟採用 ECBC 的現有 ASC／AAC 宣傳活動後，系統會提示您「複製宣傳活動」。只需點擊一下，即可建立新的宣傳活動，複製現有宣傳活動的設定。
  • 使用 API 來複製 ECBC 宣傳活動：使用此處開發人員文件所提供的指引，透過 API 複製宣傳活動。
  • 在廣告帳戶級別要求批量轉移：如果您是受管控的合作夥伴，我們可以讓您在雙方議定的日期一次過複製所有 ECBC 宣傳活動。請聯絡您的 Meta 聯絡人，並提供帳戶編號和首選轉移日期。

備註：所有建立的 ECBC 宣傳活動副本都會有新的宣傳活動編號。

此變更會影響以下端點：

  • POST /{campaign-id}
  • POST /{campaign-id}/copies

請參閱更新版開發人員文件和常見問題，以了解此項變更的所有詳情。

開發人員文件連結

功能幫助文章連結

API 版本停用資訊：

根據 Facebook 的 Graph API 和推廣 API 版本控制時間表，接下來的停用項目如下：

Graph API

  • 2026 年 5 月 21 日：Graph API v.19 停止提供服務，並會從平台中移除。
  • 2026 年 9 月 24 日：Graph API v.20 停止提供服務，並會從平台中移除。

為免導致業務中斷，我們建議您立即將所有呼叫轉移至今天發佈的最新 API 版本。


標籤

商業工具開發人員工具Graph API推廣 API

探索更多

2025年5月29日

Introducing Graph API v23.0 and Marketing API v23.0

2025年1月21日

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

2024年5月21日

Introducing Graph API v20.0 and Marketing API v20.0

接收我們的電子通訊

訂閱以接收 Meta for Developers 的每月最新消息。

訂閱