10.0 版

Graph 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 權限可升級為進階存取權限，而無需完成應用程式審查。

群組

適用於 v10.0 版及以上版本。於 2021 年 5 月 25 日起適用於所有版本。

• 為了與其他 Facebook 資料留存政策保持一致，群組 API 將僅包含查詢最近 90 天內建立的資料。系統傳回的資料取決於存取權限級別，或應用程式的模式及您的應用程式角色。
• 現在，群組 API 將使用雙級別的 API 存取權限級別系統（標準級別和特權級別），以取代開發模式和已發佈模式存取權限。標準級別存取權限將僅允許您為擁有應用程式角色的用戶獲取資料，而特權級別存取權限將允許您從安裝應用程式的群組中所有用戶身上獲取資料。

專頁

已恢復端點

適用於 v10.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」，確保該等資料永不過期。

網址

適用於 v10.0 版及以上版本。於 2021 年 5 月 25 日起適用於所有版本。

互動

• 出於私隱原因，GET /?id={url}/engagement 要求傳回的計數未必會與原始計數相符。
• 每小時為相同網址的 GET /?id={url}/engagement 欄位發出要求的次數不得超過 10 次。

推廣 API

發佈日期：2021 年 2 月 23 日 | 停用日期：2021 年 10 月 4 日 | 網誌文章

廣告帳戶

欄位變更

適用於 v10.0 版及以上版本。於 2021 年 5 月 25 日起適用於所有版本。

廣告帳戶節點的 agency_client_declaration 欄位現在需要管理員權限來執行所有操作。

廣告洞察報告 API

已更新 date_preset 參數

適用於 v10.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

請參閱類似廣告受眾：即將推出的類似廣告受眾變更，以了解更多資訊。