第 10.0 版

圖形 API

發佈日期：2021 年 2 月 23 日 | 有效期限：2023 年 6 月 8 日 | 部落格文章

商業應用程式

存取層級

適用於 2021 年 2 月 16 日之後建立的所有應用程式。

所有在 2021 年 2 月 16 日之後建立的商家類型應用程式，系統將自動授予對 email 和 public_profile 權限的標準存取。

適用於 2021 年 2 月 16 日之後建立的所有現有應用程式。

所有在 2021 年 2 月 16 日之前建立的商家類型應用程式，系統將自動授予對 email 和 public_profile 權限的進階存取。未使用 email 或 public_profile 權限的應用程式，系統會將這兩個權限降級為標準存取。

商家類型應用程式無需通過應用程式審查，即可升級為對 email 和 public_profile 權限的進階存取。

社團

適用於 10.0 以上版本。將於 2021 年 5 月 25 日套用至所有版本。

• 為了符合其他 Facebook 資料保留政策，社團 API 將僅包含過去 90 天內建立的查詢資料。傳回的資料取決於應用程式的存取層級或模式，以及應用程式的角色。
• 社團 API 現在將使用 2 階層 API 存取層級系統，即標準層級和特權層級，取代開發模式和上線模式存取。標準層級存取僅允許您取得具有應用程式角色的用戶資料，特權層級存取則允許您從安裝應用程式的社團中取得所有用戶資料。

粉絲專頁

已恢復的端點

適用於 10.0 以上版本。將於 2021 年 5 月 25 日套用至所有版本。

於第 8.0 版停用的 DELETE /{page-id}/tabs 端點已於第 10.0 版恢復，且將在 2021 年 5 月 25 日於所有版本恢復。

Threat Exchange

刪除到期資料

將於 2021 年 5 月 25 日套用至所有版本。

系統會在指示的到期時間，將上傳至包含非零 expire_time 之 ThreatExchange 的資料永久刪除。如果您希望刪除不再有效的資料，請將 expired_on 欄位設定為目前時間，以立即刪除資料。

此外，系統會在建立者設定的到期日到來時，將所有非 Facebook 的 ThreatDescriptor 永久刪除。如果應用程式的 ThreatDescriptor 目前已過期，而您不希望系統將其刪除，則必須延長到期日或將其設定為「0」，以確保資料永遠不會到期。

網址

適用於 10.0 以上版本。將於 2021 年 5 月 25 日套用至所有版本。

互動

• 基於隱私疑慮，GET /?id={url}/engagement 要求傳回的計數可能與原始計數不符。
• 同一網址的 GET /?id={url}/engagement 欄位要求將限制為每小時 10 個要求。

行銷 API

發佈日期：2021 年 2 月 23 日 | 有效期限：2021 年 10 月 4 日 | 部落格文章

廣告帳號

欄位變更

適用於 10.0 以上版本。將於 2021 年 5 月 25 日套用至所有版本。

AdAccount 節點的 agency_client_declaration 欄位現在需要所有操作的管理員權限。

廣告洞察報告 API

更新 date_preset 參數

適用於 10.0 以上版本。

• lifetime 參數（date_preset=lifetime）已停用，並以 date_preset=maximum 取代，可用於擷取最多 37 個月的資料。當要求包含超過 37 個月期間的日期範圍時，API 會傳回錯誤。
• 針對 9.0 及較舊版本，2021 年 5 月 25 日之後功能才會有所變更。屆時，date_preset=maximum 將會啟用，任何 lifetime 呼叫將預設為 maximum，並僅傳回 37 個月的資料。

商家

放寬先前的端點存取限制

適用於 10 以上版本。

在第 9.0 版中，以下端點的存取權限會受到限制。所有應用程式的存取權限已恢復，但應用程式現在只能針對已擁有它們的企業（或這些企業的子企業）：

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

目標設定

關係鏈目標設定

將於 2021 年 5 月 24 日套用至所有版本。

在建立或編輯廣告行銷活動時，下列端點不再接受關係鏈目標設定：

• POST /<ad_account_id>/adsets
• POST /<adset_id>

此變更不會影響任何現有進行中的行銷活動。

類似廣告受眾

location_spec 和 country 參數將從類似廣告受眾建立流程中移除。類似廣告受眾的位置將由行銷活動目標鎖定說明中的國家／地區地點定義。

進行此變更不會對現有的行銷活動產生影響，此要求只會影響新的和已編輯的行銷活動。

下列端點和欄位將受到影響：

• POST /<ad_account_id>/customaudiences
• POST /<ad_account_id>/adsets
• POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
• GET /<ad_account_id>/reachestimate
• GET /<ad_account_id>/delivery_estimate
• GET /<ad_account_id>?fields=approximate_count
• GET /<ad_account_id>?fields=delivery_status
• GET /<ad_account_id>?fields=operation_status

請參閱類似廣告受眾：近期的類似廣告受眾變更，以取得關於這些更新的詳細資訊。