Facebook Graph API 12.0 版和推廣 API 12.0 版簡介

今天，我們隆重推出 Facebook Graph API 12.0 版和推廣 API 12.0 版。在下文中，我們重點介紹了將對開發人員社群中部分人員造成影響的變更，其中包括公告和產品更新、之前發佈的提醒和大規模停用項目的通知，這些變更可能會影響您的應用程式與我們平台之間的整合。

如需查看所有變更的完整清單及有關詳情，請瀏覽我們的變更記錄。

一般公告及更新

轉換 API：擴展可呼叫的最低版本

為透過一鍵式存取憑證建立的應用程式提供 Graph API 向下相容功能由 12.0 版起，在事件管理工具的轉換 API 設定分頁中產生的新建立存取憑證，現已受所有可用 Graph API 版本支援（在此處查看支援版本）。

請注意，透過這些憑證向已停用的 Graph API 版本發出的呼叫，將會自動解析為最早的可用版本。此行為僅適用於 Graph API 端點。推廣 API 端點（包括轉換 API）不支援自動升級行為，並將拋出例外。

用於 Instagram 訊息功能的用戶個人檔案 API：新欄位

我們正在改進用於 Instagram 訊息功能的用戶個人檔案 API。此前，Instagram 用戶個人檔案 API 支援兩種欄位：1) 名稱和 2) 個人資料相片網址。為了允許企業根據公開可用的用戶資料來加強個人化和優先顯示訊息，我們更新了 API，以將以下資訊包含在內：

1.追蹤者數量
2.驗證徽章
3.商家關注用戶帳戶 [是/否]
4.用戶帳戶關注商業帳戶 [是/否]

請參閱開發人員文件了解詳情。

詳細目標設定：新機會

為協助廣告客戶發掘本來無法提供的額外機會，我們會在廣告客戶利用詳細目標設定，並使用轉換量目標優化轉換、值或應用程式事件時，自動將其納入目標設定擴充。如需了解更多資訊，請參閱詳細目標設定擴充幫助中心文章。

影片 API：新欄位

我們在 [Video] 節點中加入了兩個新欄位：views 和 post_views。請查看影片 API 開發人員文件了解詳情。

停用項目及重大變更

錯誤透明度

Graph API 和推廣 API 的預設行為，是當應用程式在節點上請求傳回一個或多個關聯節點的欄位或關係連線但缺少關聯節點所需的相應權限時，在此拋出錯誤。但是，當出現呼叫應用程式缺少相應權限的情況時，其中一些欄位和關係連線並不遵循此協定，而是直接從 API 回應中省略。

由 12.0 版起，這些欄位和關係連線將會遵循預設行為。從 2021 年 12 月 13 日起，此變更會套用於所有版本。

• 受影響的 Graph API 端點
• 受影響的推廣 API 端點

系統用戶及應用程式角色

除非用戶與應用程式屬於同一間企業，否則我們即將停用向系統用戶授予應用程式角色的功能。為免導致您的應用程式和業務中斷，我們建議您從應用程式中移除這些系統用戶，以及改用代客管理 API。此重大變更將於 2021 年 12 月 13 日生效。

排定時間直播

我們將在 Live API 的排定功能中停用 planned_start_time 參數，而此重大變更將於 2021 年 12 月 13 日生效。新參數將於日後公佈。

Messenger 平台：轉換 API

我們即將停用轉換 API 對話中繼資料中的 user_id 欄位。所有開發人員均需將任何參考資料轉移至 user_id (IGID)，並完全依賴 (IGSID) 及將其作為用戶和公司之間對話的主要識別資料。

此重大變更將於 2021 年 12 月 13 日在之前的 Graph API 版本上生效。請查看轉換 API 開發人員文件了解詳情。

Messenger 平台：Instagram Webhooks

為加強對表情符號心情的支援，我們將會更新 Instagram 心情 Webhooks 的 Messenger API。目前版本會以字串形式傳回表情符號欄位，而在此次更新後，心情 Webhooks 會傳回新的 unicode 格式。請注意，「心情」欄位只會支援預設表情符號。至於所有其他表情符號，「心情」欄位會傳回「其他」（與 MSGR 相同）。

由 2021 年 12 月 13 日起，此重大變更將在之前的 Graph API 版本上生效。為繼續對表情符號心情的支援，所有開發人員均需轉移至新的 unicode（將於 2021 年 12 月 13 日之前由我們傳回）。請參閱 Webhooks 開發人員文件了解詳情。

API 版本停用資訊：

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

Graph API

• 2021 年 11 月 2 日：Graph API 4.0 版將會停用，且將從平台中移除
• 2022 年 2 月 3 日：Graph API 5.0 版將會停用，且將從平台中移除
• 2022 年 5 月 22 日：Graph API 6.0 版將被停用，且將從平台中移除

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

推廣 API

• 推廣 API 10.0 版將於 2021 年 10 月 4 日停用
• 推廣 API 11.0 版將於 2022 年 2 月 23 日停用

為免導致您的業務中斷，我們建議您立即將所有呼叫轉移至今天發佈的最新推廣 API 版本。（詳情請參閱變更記錄）。

Facebook 平台 SDK

• 在 2021 年 1 月 19 日，我們為 Facebook 平台 SDK 8.x 版及以下版本推出了為期兩年的停用計劃。我們將於 2023 年 1 月停用這些版本。
• 在 2021 年 6 月 8 日，我們發佈了 Facebook 平台 SDK 11.0 版，為 Facebook 平台 SDK 9.0 版開始了為期兩年的停用計劃。SDK 9.0 版將於 2023 年 6 月停用。

一般停用項目

停用原生優惠端點

在 2021 年 6 月 8 日，我們宣佈停用優惠廣告 API。此停用內容將隨 Graph API 12.0 版的發佈即時生效。

Messenger 平台 - 航班資訊範本

在 2021 年 6 月 8 日，我們宣佈停用航班資訊範本。此停用內容將於 2021 年 12 月 6 日生效。