今天我們將推出 Facebook 圖形 API 第 12.0 版和行銷 API 第 12.0 版。以下我們已強調將影響開發人員社群部分的變更。這些變更包括公告和產品更新、舊版功能提醒,以及可能影響您應用程式與我們平台整合的大規模淘汰項目。
如需所有變更及細節的完整清單,請瀏覽我們的變更紀錄。
以單擊存取權杖所建應用程式的圖形 API 向下相容性從第 12.0 版開始,所有可用的圖形 API 版本(請在這裡參閱支援的版本),現在均支援在事件管理工具的 [轉換 API] 設定頁籤下所產生的新建存取權杖。
請注意,如以這些權杖呼叫已淘汰的圖形 API 版本,將會自動解析至最舊的可用版本。這個行為只適用於圖形 API 端點。行銷 API 端點(包括轉換 API)並不支援自動升級行為,且會擲回例外情況。
我們在強化 Instagram 用戶個人檔案 API 訊息傳送功能。Instagram 用戶個人檔案 API 原本支援兩個欄位:1) 姓名和 2) 大頭貼照的網址。為讓商家能夠更充分地呈現自我品牌,並且依據可公開取得的用戶資訊優先顯示訊息,我們已更新 API,也納入下列資訊:
1. 粉絲人數
2. 驗證標章
3. 商家追蹤用戶帳號 [是/否]
4. 用戶帳號追蹤商業帳號 [是/否]
如需詳細資訊,請參閱開發人員文件。
為協助廣告主找到更多原本不可得的機會,當廣告主使用詳細目標設定,並且使用轉換目標最佳化轉換、價值或應用程式事件時,會自動將這些項目包含在目標設定擴充中。如需詳細資訊,請參閱詳細目標設定擴充說明中心文章。
我們在 [影片] 節點已新增兩個新欄位、檢視畫面以及 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 日生效。日後將宣布一項新的參數。
我們將淘汰對話 API 中貼文串中繼資料的 user_id 欄位。所有開發人員都需要將任何參照移轉至 user_id(IGID),並且完全以 IGSID 為主要識別資料,用於識別用戶和商家之間的貼文串。
這項重大變更將於 2021 年 12 月 13 日生效,範圍是舊版的圖形 API。請查看對話 API開發人員文件以瞭解詳情。
為進一步支援表情符號心情,我們將更新我們的 Messenger API for IG 心情 Webhook。目前版本會以字串形式傳回表情符號欄位,這次更新後,則會以 Unicode 格式傳回心情 Webhooks。請注意,「心情」欄位只支援預設表情符號。至於所有其他表情符號,心情欄位則和 MSGR 一樣會傳回「其他」。
這項重大變更將於 2021 年 12 月 13 日開始生效,範圍是舊版的圖形 API。為繼續支援表情符號心情,所有開發人員皆需移轉至我們將於 2021 年 12 月 13 日傳回的新 Unicode。如需詳細資訊,請參閱 Webhook 開發人員文件。
Facebook 的圖形 API 和行銷 API 版本修訂時間表已訂出即將淘汰項目,請留意:
圖形 API
為避免干擾您的業務,我們建議將所有呼叫移轉至今天推出的最新 API 版本。
行銷 API
為避免干擾您的業務,我們建議將所有呼叫移轉至今天推出的最新行銷 API 版本。(如需詳細資訊,請瀏覽變更紀錄)。
原生優惠端點淘汰
2021 年 6 月 8 日,我們宣佈優惠廣告 API 的淘汰項目。這項更新內容會於圖形 API 第 12.0 版推出時立即生效。
Messenger 開放平台 - 航空公司範本
2021 年 6 月 8 日,我們宣佈航空公司範本的淘汰項目。這項更新內容將在 2021 年 12 月 6 日生效。