Introducing Facebook Graph API v10.0 and Marketing API v10.0
我們將在今天推出 Facebook 圖形 API 10.0 版和行銷 API 10.0 版。
此發行版本內有許多宣佈事項、更新、淘汰項目和「取消淘汰項目」，可能影響您的應用程式與我們平台的整合。本貼文概述這些更新，以及開發人員在適當情況下為避免中斷而需要採取的必要步驟。
下面提供有關所有變更的詳細資訊。如需技術規格，請瀏覽我們的 10.0 版變更紀錄。
請瀏覽平台計劃中心，以瞭解我們的開發人員平台。
宣佈事項和更新
資料使用情形檢查認證
為免失去 Facebook 開放平台 API 存取權，請在註冊後的 60 天內完成資料使用情形檢查（DUC）。您可以前往應用程式主控板中的「我的應用程式」頁面來完成 DUC。
Facebook 在去年秋天推出資料使用情形檢查（DUC），要求開發人員需每年完成一次本檢查，以確保其 API 存取和資料使用遵守 Facebook 開放平台使用條款和開發人員政策。
作為我們逐步推廣到所有應用程式的其中一步，您將透過開發人員通知收到截止日期和進一步說明，同時也會寄電子郵件至註冊的聯絡人地址，另外應用程式主控板上的必要動作清單也將顯示通知。
有關完成 DUC 的詳細說明，請參閱我們的開發人員文件。您還可以在 DUC 專用的常見問題部分中找到更多資訊。
社團 API 90 天資料存取層級和資料限制：
自 2021 年 5 月 24 日開始，使用社團 API 時，應用程式的可用資料存取期間將限制為 90 天。
我們也將推出根據消費者應用程式為開發模式或上線模式的分層式社團 API 存取。社團 API 權限目前的行為類似於企業應用程式的標準和進階存取。
現階段，處於開發模式的應用程式可以存取開發人員為管理員的公開社團和私密社團的所有內容。完成應用程式審查後，這些應用程式便能存取已安裝應用程式的社團中的所有內容。
2021 年 5 月 24 日起，處於開發模式的應用程式則只能存取開發人員為管理員的公開社團和私密社團中其自己擁有的內容。這表示該應用程式將無法存取其他社團用戶（在該應用程式上沒有角色）發佈的內容，例如貼文和留言。
如需瞭解詳情，請參閱 10.0 版變更紀錄
public_profile 存取層級和企業應用程式的電子郵件權限
作為我們保護用戶資料的不間斷措施的其中一步，我們在新推出和現有企業型應用程式適用的圖形 8.0 版發佈的存取層級模型中加入了 public_profile（亦即預設公開個人檔案欄位）和電子郵件權限。
新建立的企業型應用程式現在一開始將取得 public_profile 的標準存取和電子郵件權限。當應用程式具有 public_profile 的標準存取時，只有在該應用程式或擁有該應用程式之企業中具有角色的用戶可以搜尋或登入該應用程式。如果您需要讓外部用戶登入您的應用程式，則應用程式管理員可以在應用程式主控板中要求進階存取。系統將自動授予此存取。
如需瞭解詳情，請參閱 10.0 版變更紀錄
資料刪除要求提醒
根據 2020 年 11 月 10 日的公告，將要求提交供應用程式審查或從開發模式轉換為上線模式的消費者和遊戲應用程式類型提供資料刪除要求回呼，或包含關於用戶如何要求刪除其資料的明確說明的網址。我們計劃在 2022 年 11 月 10 日之前強制執行此要求，並將在執行的 60 天前提醒應用程式開發人員。
適用於留存時間縮短專案的圖形 AdsInsight API 變更選項
廣告管理員用戶介面將不再支援 37 個月之前的廣告洞察報告衡量指標資料回報。當要求包含的日期範圍超過 37 個月的留存時間時，API 將傳回錯誤。我們將停用「date_preset = lifetime」並將其換為「date_preset = maximum」。
圖形 API 10.0 版變更為 AdsInsight，「date_preset = lifetime」除外，其將於 90 天後套用至圖形 API 的所有其他版本。呼叫的特定欄位不需要變更。將具有預設功能，且所有「Lifetime」呼叫的預設留存時間最長均為 37 個月。
此變更不會影響與廣告創意、廣告受眾、投遞設定或廣告物件名稱相關的資料，而且現有衡量指標的計算也不會變更。此變更將套用至各種廣告分析報告介面，包括廣告管理員、廣告分析報告和輕型廣告體驗。
- 發佈日期 2021 年 2 月 23 日：
- 10.0 版
- 啟用「date_preset = maximum」
- 停用「date_preset = lifetime」
- 當要求包含的明確日期範圍超過 37 個月的留存時間時，將傳回錯誤
- 9.0 以下版本
- 現有功能無變更
- 10.0 版
- 發佈的 90 天後 - 2021 年 5 月 24 日：
- 9.0 以下版本
- 啟用「date_preset = maximum」（與新版本相同）
- 當要求包含的明確日期範圍超過 37 個月的留存時間時，將傳回錯誤（與新版本相同）
- 「date_preset = lifetime」仍有效，但只會傳回 37 個月內的資料，也就是說，其作用如同 maximum
- 9.0 以下版本
如需瞭解詳情，請參閱 10.0 版變更紀錄
適用於 ThreatExchange 上外部擁有資料的全新刪除政策
自 2021 年 5 月 24 日開始，當合作夥伴在上傳到 ThreatExchange 的資料上設定 expire_time 時，我們將在上述到期時間「硬刪除」資料。如果您想指名資料不再有效，請將「expired_on」欄位設定為自動刪除。
以往，「軟」刪除係指我們將到期的內容標記為已到期。我們不再支援軟刪除，且內容到期後，我們將硬刪除資料，且資料將不會再出現在 ThreatExchange 中。
此外，一旦 ThreatExchange 中的所有非 Facebook ThreatDescriptor 到期，便會將其硬刪除。到期時間將繼續由 ThreatDescriptor 的建立者設定。接著將開始刪除所有非 Facebook 建立的已到期 ThreatDescriptor。如果您的應用程式目前已到期，且您不想在此政策生效時刪除 ThreatDescriptor，則必須延後到期日期或將其設為「0」，以確保資料永不到期。
新 API 中的目標設定變更
自 2021 年 5 月 24 日起，我們在 API 所有版本中建立類似自訂廣告受眾時將不再要求 location_spec 和國家／地區參數。
建立類似廣告受眾時，用戶會選擇類似廣告受眾來源和所要的比例。類似廣告受眾的位置將由行銷活動的目標設定說明中的國家／地區地點定義。進行此變更不會對現有的行銷活動產生影響。此變更只會影響新的和已編輯的行銷活動。
推出全新平台上線狀態頁面
全新的 Facebook 商家狀態頁面將提高透明度並與使用 Facebook 開放平台產品的外部開發人員主動通訊。此頁面將提供集中的位置，以檢查 Facebook 的商業產品（廣告、WhatsApp Business API、Facebook 開發人員平台等）的平台狀態。此頁面目前已在廣告管理員和 WhatsApp Business API 中上線，且其他商業產品將在 2021 年 5 月之前陸續加入。
淘汰項目
淘汰「開始直播」對話方塊
「開始直播」對話方塊（GLD）SDK 將於 2021 年 5 月 24 日淘汰。此舊版直播生產工具的淘汰項目將套用至 API 所有版本。此變更只會影響 Facebook 上的直播。我們鼓勵開發人員使用 Live Producer 和 Live API 於所有自訂的直播生產解決方案。
GLD SDK 淘汰後用於開始直播的解決方案：
- 透過 facebook.com/live/producer（或 Facebook 上的其他進入點，例如粉絲專頁或個人檔案上的「直播」按鈕）直接存取 Live Producer
- 將任何自訂解決方案與 Live API 整合
如需瞭解詳情，請參閱 10.0 版變更紀錄
關係鏈目標設定淘汰
自 2021 年 5 月 24 日開始，建立／編輯廣告組合時將不再支援「關係鏈目標設定」。此要求只會影響新的和已編輯的行銷活動，不會對現有的行銷活動產生影響。
如需瞭解詳情，請參閱 10.0 版變更紀錄
取消淘汰項目
取消淘汰 gr:delete:Page/tabs 端點
推出圖形 API 8.0 版時，我們已淘汰「粉絲專頁」頁籤的 gr:delete:Page/tabs 端點。我們決定立即取消淘汰圖形 API 10.0 版的此端點，並將在 2021 年 5 月 24 日恢復其在所有其他圖形版本中的存取。
如需瞭解詳情，請參閱 10.0 版變更紀錄
取消淘汰 gr:post:Business/business_users、gr:post:Business/system_users 和 gr:post:User/access_tokens 端點
推出圖形 API 9.0 版時，我們已限制存取以下三個企業端點：
- gr:post:Business/business_users
- gr:post:Business/system_users
- gr:post:User/access_tokens
自圖形 10.0 版推出後，當應用程式滿足以下兩個條件之一時，我們將對 API 呼叫重新開放這些端點：
- 目標企業是呼叫應用程式的擁有企業
- 目標企業是呼叫應用程式的擁有企業的子企業（在企業 2 層模型中）
如需瞭解詳情，請參閱 10.0 版變更紀錄
執行項目行事曆
行銷 API 版本淘汰項目：
依照我們的行銷 API 版本排程，請留意即將到來的行銷 API 版本淘汰項目：
- 2021 年 3 月 3 日：行銷 API 7.0 版將從平台中淘汰並移除
- 2021 年 5 月 4 日：行銷 API 8.0 版將從平台中淘汰並移除
- 2021 年 8 月 25 日：行銷 API 9.0 版將從平台中淘汰並移除
為避免干擾您的業務，我們建議將所有呼叫移轉至今天推出的最新行銷 API 版本。（如需詳細資訊，請瀏覽變更紀錄）。
圖形 API 版本淘汰項目：
依照我們的圖形 API 版本排程，請留意以下列出即將到來的圖形 API 版本淘汰項目：
- 2021 年 5 月 4 日：圖形 API 3.2 版將從平台中淘汰並移除
- 2021 年 8 月 3 日：圖形 API 3.3 版將從平台中淘汰並移除
一般淘汰項目
- 2021 年 5 月 24 日：
- 「開始直播」對話方塊將從平台中淘汰並移除
- 關係鏈目標設定將從平台中淘汰並移除
開發人員需採取動作
- 滾動式註冊：資料使用情形檢查認證
- 註冊後，需在 60 天內完成
- DUC 專用常見問題部分。
- 2021 年 2 月 23 日：推出僅適用於圖形 10.0 版的圖形 AdsInsight API 變更
- 2021 年 5 月 24 日：
- 推出適用於圖形 9.0 以下版本的圖形 AdsInsight API 變更
- 符合應用程式審查的存取層級變更開始生效
- 社團 API 資料存取限制為 90 天
- 社團 API 分層資料層級已實施
- public_profile 和企業應用程式的電子郵件權限變更開始生效
- ThreatExchange 上的全新「硬刪除」資料政策已實施
- 2022 年 11 月 10 日：資料刪除要求截止日期
