推出 Facebook Graph API v16.0 版和推廣 API v16.0 版

今天，我們隆重推出 Facebook Graph API v16.0 版和推廣 API v16.0 版。為配合這些發佈版本推出，我們於下方重點列出了我們認為與部分開發人員社群相關的變更。這些變更包括公告、產品更新和停用通知，而我們認為這些變更跟您應用程式與我們平台之間的整合息息相關。

有關所有變更及詳情的完整清單，請參閱我們的變更記錄。

一般公告及更新

WhatsApp Business 平台錯誤回應

我們一直在努力改善 API 錯誤回應行為，為此我們作出了以下變更。

• v16.0 版及更新版本的錯誤回應中將不再包含錯誤子代碼。這是由於錯誤子代碼的使用頻率較低，而且我們不應該對其加以依賴。請改為使用 code 和 details 屬性。
• 錯誤代碼 100（"code":100）之前有多個不重複的標題，用於表示所涉錯誤的性質。現在，所有 100 錯誤代碼都會以「參數無效」為標題。之前用於描述所涉 100 錯誤代碼性質的舊標題現已移至 details 屬性中。此變更現在也會反映在描述 100 錯誤代碼回應的 Webhooks 裝載中。
• Webhook 錯誤物件已獲得新的 message 屬性，此屬性會與 API 錯誤回應裝載中的 message 屬性對應。

開發人員平台現在要求用戶完成商家驗證以獲取任何 API 的進階存取權限

如同我們在 2023 年 2 月 1 日的公告所述，Meta 現在要求開發人員必須驗證其商家，才能獲得 Meta 開發人員平台上任何權限的進階存取權限。此要求是我們用來確認商家或機構是否屬實和合法的流程之一。

我們會逐步對 2023 年 2 月 1 日之後建立的應用程式實行此措施，在新應用程式要求獲取進階存取權限時逐步擴大此措施的實行範圍。由 2023 年 5 月 1 日起，在 2023 年 2 月 1 日前建立且具有進階存取權限的應用程式必須與已驗證的商家連結。如需了解哪些進階存取權限級別的權限需要您先通過商家驗證才會獲批，請瀏覽此頁面以查看詳盡清單。

停用項目及重大變更

停用觸動旅遊意願功能

我們在 2018 年推出了觸動旅遊意願功能，讓旅遊業廣告客戶透過開啟此開關，以優先鎖定已經表明旅遊意願但尚未決定目的地的用戶，向這類受眾刊登廣告。觸動旅遊意願功能是與現有的受眾目標選項一同運作，以幫助廣告客戶把握適當的時機，於 Facebook、Instagram 和 Audience Network 上向理想的受群刊登廣告。在過去 4 年內，經過我們持續開發機器學習系統和進行全面的測試，現在旅遊業廣告客戶無需開啟此功能，我們也能助其接觸有旅遊意願的消費者並實現類似的成效目標。

由 2023 年 2 月 2 日起，廣告管理員和 API 會為新的宣傳活動移除觸動旅遊意願開關。我們判斷不再需要此開關，各位廣告客戶即使沒有此開關也預計能獲得相同的成效。在過渡期間，開啟或關閉此開關對宣傳活動的表現不太可能會有明顯的影響。

隨著機器學習模型的改善，廣告客戶無需此開關選項也可達到相同的目標和表現，因此我們認為將其移除可帶來更簡化的體驗。

停用旨在開發潛在顧客的航班廣告

我們在 2018 年 9 月推出了旨在開發潛在顧客的航班廣告，而且大獲成功。在 2021 年的年中，此產品開始面臨技術挑戰，我們發現了會導致宣傳活動無法有效進行的錯誤。因此，我們決定主動告知廣告客戶轉用其他的開發潛在顧客選項。相關的再營銷功能仍然保留如初，廣告客戶可以繼續使用。

如果您或者您的合作夥伴目前正在使用旨在開發潛在顧客的航班廣告，我們建議在 2023 年 5 月 1 日前關閉任何現有宣傳活動。

停用即時文章廣告版位

由 2023 年 4 月 20 日起，我們會從 Facebook 移除即時文章和即時文章廣告版位。我們於 2015 年首次推出即時文章功能，發佈商可借助此功能製作出在流動裝置上顯示的互動式媒體文章，並透過 Facebook 廣告以此營利。然而，對於 Facebook 的大部分用戶而言，新聞探索體驗只是 Facebook 體驗的一小部分，而且我們收到意見指希望在動態消息中減少顯示此類內容。因此，我們將調整投資方向，以更妥善地迎合用戶的偏好。

由 2023 年 4 月 20 日起，在廣告管理員中及推廣 API 的新宣傳活動建立流程中，我們將不再提供即時文章廣告版位。在 2023 年 4 月 20 日以後，之前建立的廣告組合如果只有選用即時文章版位，均將會被暫停刊登，而所有其他有選用即時文章版位的廣告組合則會自動更新，以排除此版位。

在用戶個人檔案中發佈的內容上隱藏心情、回應和標籤

在此版本實行的變更中，我們會隱藏連線階段用戶的回應、心情和標籤。系統也會就用戶個人檔案帖子的「via」和「sharedposts」欄位傳回空白資料。此變更將只影響發佈在用戶個人檔案的內容。

停止支援 1.2 版之前的 TLS 版本

為了加強安全部署，我們會停用支援 TLS 1.2 版之前 TLS 版本的 Graph API。如果您使用 TLS 1.2 版，也將無法再透過 RSA 密碼（AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA、AES256-SHA、DES-CBC3-SHA）存取內容。使用 TLS 舊版本發出的 API 要求會在 90 天後收到錯誤訊息。

在 2023 年 5 月 1 日以後，我們還會拒絕由使用 TLS 舊版本（TLS 1.2 之前的版本，以及使用 RSA 密碼 [AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA、AES256-SHA、DES-CBC3-SHA] 的 TLS1.2）的瀏覽器向 developer.facebook.com 發出的網站流量。

WhatsApp 範本類別

我們去年在 WhatsApp 管理工具和 API 中更新了範本類別類型，以涵蓋在 WhatsApp Business 平台上傳送的新使用案例。在 2023 年 2 月 2 日，我們將這些範本類別重新命名，以更加準確地反映這些使用案例：

• 營銷類別範本將繼續命名為「營銷」 （無更改）
• 交易類別範本將重命名為「工具」
• 單次密碼範本將重命名為「驗證」

企業如使用 Graph v16 版建立或編輯範本，則必須使用這些更新後的範本類別。在 5 月 1 日，有關變更將適用於所有版本，屆時不論使用任何版本來建立或編輯範本都必須使用這些新類別。為了確保不中斷範本的建立或編輯流程，在 2023 年 5 月 1 日前，企業和企業解決方案供應商應該優先更新其 API 呼叫，以使用新的類別有效值和範本。

其他一些重要日期和注意事項如下所示：

• 範本轉移：WhatsApp 會於 4 月 1 日將所有現有範本轉移至新的範本類別。商家可在 WhatsApp 管理工具中查看其範本的新分類，並可在 5 月 15 日前進行審視此分類結果。如果企業不同意此分類，可在 5 月 15 日前提交申訴。在 4 月 1 日至 5 月 1 日期間以 Graph API v15 版或更舊版本新建立或編輯的任何範本，都將於 5 月 5 日轉移至新範本類別。因此，我們建議從 4 月 1 日起開始在建立範本時呼叫 v16 版。由 5 月 1 日起，以 WhatsApp 管理工具或任何 Graph API 版本建立的任何範本都將使用新的範本類別。
• 新範本類別的範本建立流程：由 4 月 1 日起，在 Graph API v16 版和 WhatsApp 管理工具中建立的所有範本都需要通過類別驗證以取得審批。如果 WhatsApp 偵測到新建立或編輯的範本選擇了錯誤的類別，便可能會拒絕有關範本。有關拒絕原因中會說明所選類別與範本內容不符，有違我們的範本守則。商家隨後可以選擇修改類別選項並重新提交、編輯範本或就我們的決定提出申訴。由 5 月 1 日起，新建立而內有變數的範本將需要提供內嵌式範例。由 6 月 1 日起，我們將根據新的範本類別價目表來向商家收費。

Messenger API 平台

由 v16 版開始，我們會移除指定訊息頻率的選項，以簡化定期通知功能。詳情請參閱 Messenger 變更記錄。

API 版本停用資訊：

根據 Facebook 的 Graph API 和推廣 API 版本控制計劃，請注意以下即將停用的項目：

Graph API

• 2023 年 2 月 23 日：Graph API v9.0 版會被停用並從平台移除
• 2023 年 6 月 8 日：Graph API v10.0 版會被停用並從平台移除
• 2023 年 9 月 14 日：Graph API v11.0 版會被停用並從平台移除

推廣 API

• 2023 年 4 月 25 日：推廣 API v14.0 版會被停用並從平台移除

為免對您的業務造成干擾，我們建議您立即將所有呼叫轉移至今天發佈的最新 API 版本。

Facebook 平台 SDK

根據我們平台 SDK 的兩年停用計劃，請注意以下即將停用和棄用的項目：

• 2023 年 6 月：Facebook 平台 SDK v9.0 版或以下版本會被棄用
• 2023 年 10 月：Facebook 平台 SDK v11.0 版或以下版本會被棄用
• 2024 年 2 月：Facebook 平台 SDK v12.0 版或以下版本會被棄用