Introducing Facebook Graph API v12.0 and Marketing API v12.0
今天我們將推出 Facebook 圖形 API 第 12.0 版和行銷 API 第 12.0 版。以下我們已強調將影響開發人員社群部分的變更。這些變更包括公告和產品更新、舊版功能提醒，以及可能影響您應用程式與我們平台整合的大規模淘汰項目。
如需所有變更及細節的完整清單，請瀏覽我們的變更紀錄。
一般公告與更新
轉換 API：擴充可呼叫的最小版本
以單擊存取權杖所建應用程式的圖形 API 向下相容性從第 12.0 版開始，所有可用的圖形 API 版本（請在這裡參閱支援的版本），現在均支援在事件管理工具的 [轉換 API] 設定頁籤下所產生的新建存取權杖。
請注意，如以這些權杖呼叫已淘汰的圖形 API 版本，將會自動解析至最舊的可用版本。這個行為只適用於圖形 API 端點。行銷 API 端點（包括轉換 API）並不支援自動升級行為，且會擲回例外情況。
Instagram 用戶個人檔案 API 訊息傳送功能：新欄位
我們在強化 Instagram 用戶個人檔案 API 訊息傳送功能。Instagram 用戶個人檔案 API 原本支援兩個欄位：1) 姓名和 2) 大頭貼照的網址。為讓商家能夠更充分地呈現自我品牌，並且依據可公開取得的用戶資訊優先顯示訊息，我們已更新 API，也納入下列資訊：
1. 粉絲人數
2. 驗證標章
3. 商家追蹤用戶帳號 [是/否]
4. 用戶帳號追蹤商業帳號 [是/否]
如需詳細資訊，請參閱開發人員文件。
詳細目標設定新增機會
為協助廣告主找到更多原本不可得的機會，當廣告主使用詳細目標設定，並且使用轉換目標最佳化轉換、價值或應用程式事件時，會自動將這些項目包含在目標設定擴充中。如需詳細資訊，請參閱詳細目標設定擴充說明中心文章。
影片 API：新欄位
我們在 [影片] 節點已新增兩個新欄位、檢視畫面以及 post_views。請查看影片 API 開發人員文件以瞭解詳情。
淘汰項目與重大變更
錯誤資訊透明度
圖形 API 和行銷 API 預設行為是當應用程式在傳回相關節點的節點要求欄位或關係連線，但沒有該相關節點所需的適當權限時擲回錯誤。不過，其中許多欄位和關係連線並未遵守這個通訊協定，如果發出呼叫的應用程式缺少適當權限時，只會從 API 回應直接略過這些欄位和關係連線。
從第 12.0 版開始，這些欄位和關係連線將遵守預設行為。這項變更將於 2021 年 12 月 13 日適用於所有版本。
系統用戶和應用程式角色
我們將淘汰系統用戶在應用程式得到角色權限的功能（除非用戶和應用程式屬於相同商家）。為避免您的應用程式和業務中斷，建議您移除應用程式中的系統用戶，改用 Business On Behalf Of API。這項重大變更將於 2021 年 12 月 13 日生效。
排定發佈的直播
我們將淘汰 Live API 中排程功能內的 planned_start_time 參數，這項重大變更將於 2021 年 12 月 13 日生效。日後將宣布一項新的參數。
Messenger 開放平台：對話 API
我們將淘汰對話 API 中貼文串中繼資料的 user_id 欄位。所有開發人員都需要將任何參照移轉至 user_id（IGID），並且完全以 IGSID 為主要識別資料，用於識別用戶和商家之間的貼文串。
這項重大變更將於 2021 年 12 月 13 日生效，範圍是舊版的圖形 API。請查看對話 API開發人員文件以瞭解詳情。
Messenger 開放平台：Instagram Webhooks
為進一步支援表情符號心情，我們將更新我們的 Messenger API for IG 心情 Webhook。目前版本會以字串形式傳回表情符號欄位，這次更新後，則會以 Unicode 格式傳回心情 Webhooks。請注意，「心情」欄位只支援預設表情符號。至於所有其他表情符號，心情欄位則和 MSGR 一樣會傳回「其他」。
這項重大變更將於 2021 年 12 月 13 日開始生效，範圍是舊版的圖形 API。為繼續支援表情符號心情，所有開發人員皆需移轉至我們將於 2021 年 12 月 13 日傳回的新 Unicode。如需詳細資訊，請參閱 Webhook 開發人員文件。
API 版本淘汰項目：
Facebook 的圖形 API 和行銷 API 版本修訂時間表已訂出即將淘汰項目，請留意：
圖形 API
- 2021 年 11 月 2 日：將淘汰圖形 API 第 4.0 版並自開放平台中移除
- 2022 年 2 月 3 日：將淘汰圖形 API 第 5.0 版並自開放平台中移除
- 2022 年 5 月 22 日：將淘汰圖形 API 第 6.0 版並自開放平台中移除
為避免干擾您的業務，我們建議將所有呼叫移轉至今天推出的最新 API 版本。
行銷 API
- 行銷 API 第 10.0 版將於 2021 年 10 月 4 日淘汰
- 行銷 API 第 11.0 版將於 2022 年 2 月 23 日淘汰
為避免干擾您的業務，我們建議將所有呼叫移轉至今天推出的最新行銷 API 版本。（如需詳細資訊，請瀏覽變更紀錄）。
Facebook 開放平台 SDK
- 我們於 2021 年 1 月 19 日宣佈開始為期 2 年的淘汰時間表，適用於 Facebook 開放平台 SDK 第 8.x 版和以下版本。這些版本將於 2023 年 1 月淘汰。
- 我們於 2021 年 6 月 8 日推出了 Facebook 開放平台 SDK 第 11.0 版，開始為期 2 年的 Facebook 開放平台 SDK 第 9.0 版淘汰階段。SDK 第 9.0 版將於 2023 年 6 月淘汰。
一般淘汰項目
原生優惠端點淘汰
2021 年 6 月 8 日，我們宣佈優惠廣告 API 的淘汰項目。這項更新內容會於圖形 API 第 12.0 版推出時立即生效。
Messenger 開放平台 - 航空公司範本
2021 年 6 月 8 日，我們宣佈航空公司範本的淘汰項目。這項更新內容將在 2021 年 12 月 6 日生效。
