Introducing Facebook Graph API v10.0 and Marketing API v10.0

我們在今天推出 Facebook Graph 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 和 email 權限之的存取權限級別

在實施這項持續計劃以保護用戶數據安全的過程中，我們在 Graph 8.0 版公佈的存取權限級別模型中加入了 public_profile（即預設公開個人檔案欄位）和 email 權限，適用於全新和現有的企業類型應用程式。

現在，新建立的企業類型應用程式會在一開始獲授予 public_profile 和 email 的標準存取權限。如果應用程式持有 public_profile 的標準存取權限，只有擁有應用程式角色的用戶，或在已領取此應用程式的企業中擁有角色的用戶，才能搜尋或登入此應用程式。如果您需要讓外部用戶登入您的應用程式，應用程式廣告管理員可以在應用程式管理中心中要求進階存取權限。系統會自動授予此存取權限。

如需了解詳情，請查看 10.0 版變更記錄

數據刪除要求提醒

正如我們在 2020 年 11 月 10 日所宣佈，每當將消費者和遊戲應用程式類型提交至應用程式審查時，或從開發模式轉變為已發佈模式時，均需提供數據刪除要求回調，或提供具有明確說明的網址，讓用戶了解如何要求刪除自己的數據。我們計劃在 2022 年 11 月 10 日前落實此要求，並在落實之前 60 天提醒應用程式開發人員。

Graph AdsInsight API 中留存時間縮短專案的變更選項

廣告管理員用戶介面將不再為超出 37 個月前的廣告洞察報告衡量數據提供分析報告。當要求中包含的日期範圍超出 37 個月的留存時間時，API 會傳回錯誤。我們將停用「date_preset = lifetime」，改為使用「date_preset = maximum」。

Graph API 10.0 版中對 AdsInsight 的變更（「date_preset = lifetime」除外）將在 90 天後套用於 Graph API 的所有其他版本。調用的特定欄位無需更改。系統將推出預設功能，所有「Lifetime」調用的留存時長上限都將預設為 37 個月。

此項變更不會影響與廣告創意、分享對象、刊登設定或廣告物件名稱相關的數據，而且現有衡量數據的計算方式也不會發生任何變更。此項變更將套用至所有廣告分析報告平台，包括廣告管理員、廣告分析報告和輕巧廣告體驗。

• 發佈日期 23/2/2021：
  • 10.0 版本
    • 啟用「date_preset = maximum」
    • 停用「date_preset = lifetime」
    • 當要求中包含的明確日期範圍超出 37 個月的留存時間時，系統會傳回錯誤
  • 9.0 版本及更舊版本
    • 目前功能維持不變
• 發佈後 90 天 - 05/24/2021：
  • 9.0 版本及更舊版本
    • 啟用「date_preset = maximum」（與新版本相同）
    • 當要求中包含的明確日期範圍超出 37 個月的留存時間時，系統會傳回錯誤（與新版本相同）
    • 「date_preset = lifetime」仍可正常使用，但只能傳回 37 個月內的數據，亦即如同設定上限

如需了解詳情，請查看 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 月加入更多企業產品。

停用項目

停用「開始直播」對話框

我們將在 2021 年 5 月 24 日停用「開始直播」對話框 (GLD) SDK。我們將在所有版本的 API 中停用舊版直播生產工具。此變更只會影響 Facebook 上的直播。我們建議開發人員將直播管理工具和 Live API 用於所有自訂直播生產解決方案。

將在 GLD SDK 停用後推出的解決方案：

• 直接透過 facebook.com/live/producer（或 Facebook 上的其他入口點，例如專頁或個人檔案上的「直播視像」按鈕）存取直播管理工具。
• 將所有自訂解決方案與 Live API 整合

如需了解詳情，請查看 10.0 版變更記錄

聯絡人目標指定停用項目

在 2021 年 5 月 24 日，建立/編輯廣告組合時將不再支援聯絡人目標指定。此項要求只會影響新的宣傳活動和編輯後的宣傳活動，現有宣傳活動不會受到任何影響。

如需了解詳情，請查看 10.0 版變更記錄

取消停用項目

取消停用端點 gr:delete:Page/tabs

早前推出 Graph API 8.0 版時，我們為專頁標籤頁停用了 gr:delete:Page/tabs 端點。我們決定於 Graph API 10.0 版立即取消停用此端點，並將於 2021 年 5 月 24 日在所有其他 Graph 版本中恢復其存取權限。

如需了解詳情，請查看 10.0 版變更記錄

取消停用端點 gr:post:Business/business_users、gr:post:Business/system_users 和 gr:post:User/access_tokens

早前推出 Graph API 9.0 版時，我們限制了對三個企業端點的存取權限：

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

隨著 Graph 10.0 版發佈，我們將在應用程式符合以下兩個條件中任何一個時，向 API 調用重新開放這些端點：

• 目標企業擁有發出調用的應用程式
• 目標企業是發出調用的應用程式之持有企業的子企業（在雙層企業模型）

如需了解詳情，請查看 10.0 版變更記錄

執行項目日曆

推廣 API 版本停用項目：

根據我們的推廣 API 版本控制時間表，請注意即將停用的推廣 API 版本：

• 2021 年 3 月 3 日：推廣 API 7.0 版將被停用，並將從平台中移除
• 2021 年 5 月 4 日：推廣 API 8.0 版將被停用，並將從平台中移除
• 2021 年 8 月 25 日：推廣 API 9.0 版將被停用，並將從平台中移除

為免導致您的業務中斷，我們建議您立即將所有調用遷移到今天發佈的最新推廣 API 版本。（詳情請瀏覽變更記錄。）

Graph API 版本停用項目：

根據我們的 Graph API 版本控制時間表，請注意下列即將停用的 Graph API 版本：

• 2021 年 5 月 4 日：Graph API 3.2 版將被停用，並將從平台中移除
• 2021 年 8 月 3 日：Graph API 3.3 版將被停用，並將從平台中移除

一般停用項目

• 2021 年 5 月 24 日：
  • 「開始直播」對話框將被停用，並將從平台中移除
  • 聯絡人目標指定將被停用，並將從平台中移除

開發人員必須執行的動作

• 持續開放註冊：數據使用情形檢查認證
  • 必須在註冊後的 60 日內完成
  • 專為 DUC 而設的常見問題部分。
• 2021 年 2 月 23 日：只為 Graph 10.0 版推出 Graph AdsInsight API 變更
• 2021 年 5 月 24 日：
  • 為 Graph 9.0 版及更舊版本推出 Graph AdsInsight API 變更
  • 基於應用程式審查的存取權限級別變更生效
    • 群組 API 數據存取限制至 90 天
    • 實施群組 API 分級數據級別
    • 企業應用程式 public_profile 和 email 權限的變更生效
  • 在 ThreatExchange 上實施新的「硬性刪除」數據政策
• 2022 年 11 月 10 日：數據刪除要求截止期限