圖形 API

3.1 版

發佈日期：2018 年 7 月 26 日 | 有效期限：2020 年 10 月 27 日 | 部落格文章

一般

這些變更適用於 3.1 以上版本，且將於 2018 年 10 月 24 日套用至所有版本。

所有圖形 API 端點現在將傳回所有空的結構體為 {}，並傳回所有空的清單為 []。

Live API

這些變更適用於 3.1 以上版本，且將於 2018 年 10 月 24 日套用至所有版本。

type 參數在以下關係連線中將停用。其已由新的 source 參數取代。

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

新的 source 參數可接受下列兩個可能值其中之一：target 和 owner。使用 source=target 查詢節點的 /live_videos 關係連線，將傳回串流至該節點的直播視訊，而查詢 source=owner 將傳回該節點所串流的直播視訊。

事件和群組節點僅支援 target 查詢，而且假如您沒有檢視目標節點的權限，部分 target 查詢可能會失敗。

行銷 API

發佈日期：2018 年 7 月 26 日 | 有效期限：2019 年 5 月 14 日 | 部落格文章

廣告管理

  • 行為型目標設定類別 - 我們已停用 behaviors 中所使用的部分行為型目標設定選項。如果您嘗試使用其中一種類別建立廣告，將發生 The category you selected is no longer available. 錯誤。若要檢查可用於目標設定的有效類別，請使用目標設定搜尋。

  • 已停用作為optimization_goal 的 PAGE_ENGAGEMENT - 我們已針對廣告行銷活動，停用作為 optimization_goal 的 PAGE_ENGAGEMENT。從第 3.1 版開始，您將無法再使用設定為 PAGE_ENGAGEMENT 的 optimization_goal 來建立、更新或複製廣告行銷活動。如果您在第 3.1 版之前就建立了既有的廣告行銷活動，則仍可使用此設定執行已建立的行銷活動。您也可以繼續使用 PAGE_ENGAGEMENT，對使用此 optimization_goal 的既有廣告行銷活動資料進行洞察報告 API 資料解析。

  • 已停用不具貼文的單一圖像粉絲專頁推讚廣告 - 從第 3.1 版開始，您將無法再建立不具粉絲專頁貼文的單一圖像粉絲專頁推讚廣告。取而代之的，您應建立具有貼文的粉絲專頁推讚廣告，請參閱廣告創意、刊登版位和畫面預覽，建立粉絲專頁推讚廣告。

  • 停止透過開發階層的 Webhooks 擷取名單型廣告 - 我們將停止透過 Webhooks 將在名單型廣告表單中收集的資料傳送至開發模式中的應用程式。我們會在 2019 年 2 月 1 日開始強制執行此變更。

    • 如果您在第 3.1 版中訂閱更新，我們將不會發送任何更新，除非您的應用程式處於製作階段和上線模式中。

    • 如果您在第 3.1 版推出後才建立新的應用程式，我們將不會發送任何更新，除非您的應用程式處於製作階段和上線模式中。

    • 如果是既有的應用程式，必須在 2019 年 2 月 1 日前進入上線模式。在此日期之前，您將繼續在開發模式中接收更新。

    如需深入瞭解行銷 API 存取階層和應用程式模式，請參閱行銷 API 存取的全新架構和行銷 API，存取與驗證。

廣告洞察報告與成效衡量

  • 我們針對洞察報告 API，分別將 cost_per_store_visit 和 store_visits 重新命名為 cost_per_store_visit_actions 和 store_visit_actions。這項變更會影響：

    • GET {adaccount-id}/insights、

    • GET {campaign-id}/insights、

    • GET {adset-id}/insights、

    • GET {ad-id}/insights、

    • POST {adaccount-id}/insights、

    • POST {campaign-id}/insights、

    • POST {adset-id}/insights 和

    • POST {ad-id}/insights。

    如需瞭解全新命名的衡量指標，請參閱來店客流量，成效衡量。請注意，來店客流量 API 和相關說明文件為有限提供。若要申請使用權限，請聯絡您的 Facebook 業務代表。

企業管理平台 API

在第 3.1 版中，我們引入工作型權限的新概念，以取代目前的角色型權限。這會影響對廣告帳號（由企業管理平台 API 所管理）和粉絲專頁的存取權。您仍可使用對廣告帳號和粉絲專頁的角色型存取權，但將來會停用。這會影響以下角色，並為廣告帳號提供同等工作：

角色 工作 說明

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

管理廣告行銷活動、分析報告、帳單及廣告帳號權限的所有層面。

GENERAL_USER

['ADVERTISE', 'ANALYZE']

使用與此廣告帳號連結的支付方式建立廣告。執行分析報告。

GENERAL_USER

['ANALYZE']

執行分析報告。

這會使用下列工作取代以下企業管理平台 API 中的角色：

角色 工作

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

對於 Facebook 像素的管理，這會影響以下角色並引入新的工作：

角色 工作

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

在此變更中，我們將停用以下企業管理平台 API 欄位，並以下列項目取代：

範圍 已停用 新增欄位

GET {adaccount-id}/users

permissions、role

tasks

POST {adaccount-id}/users

role、uidRoles、emailRoles

tasks

GET {user-id}/adaccounts

permissions、role

tasks

GET {user-id}/assigned_ad_accounts

role、permitted_role

tasks、permitted_tasks

GET {user-id}/assigned_pages

role、permitted_role

tasks、permitted_tasks

GET {adaccount-id}/assigned_users

role、permitted_role

tasks、permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role、permitted_role

tasks、permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role、permitted_role

tasks、permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

此全新設計也會影響粉絲專頁 API，請參閱圖形 API 3.1，粉絲專頁 API，重大變更。如需企業管理平台 API 說明文件，請參閱：

Messenger 平台

針對 2018 年 7 月 26 日之前建立的應用程式，這些變更將於 2019 年 1 月 8 日生效。針對 2018 年 7 月 26 日之後建立的應用程式，這些變更將立即生效。

用戶個人檔案 API 現在預設只會傳回 first_name、last_name 和 profile_pic 欄位。其他欄位現在需從「應用程式主控板」的「Messenger 平台」頁籤接受產品審查。

last_ad_referral 和 is_payment_enabled 欄位已停用，將於 2018 年 10 月 30 日從 API 移除。

共同朋友 API

這些變更適用於 3.1 以上版本，且將於 2018 年 10 月 24 日套用至所有版本。

共同朋友 API 已於 2018 年 4 月 4 日停用，下列端點將開始傳回空的資料集。端點目前已完全停用，且將傳回錯誤。

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

粉絲專頁 API

權限

下列變更適用於 3.1 以上版本，且將於 2019 年 2 月 1 日套用至所有版本。

pages_manage_cta 權限現在要求需針對所有 POST 和 DELETE 要求進行應用程式審查。2018 年 7 月 26 日之前建立的應用程式可繼續使用此權限，但必須在 2019 年 2 月 1 日之前提交進行審查，才能繼續使用 pages_manage_cta。

粉絲專頁角色

下列變更適用於 3.1 以上版本。

粉絲專頁角色正在停用，且將由粉絲專頁工作取代。您將不再授予用戶粉絲專頁上的角色，而是授予用戶同等工作。

角色同等工作

Admin

ADVERTISE、ANALYZE、CREATE_CONTENT、MANAGE、MODERATE

Advertiser

ADVERTISE、ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE、ANALYZE、CREATE_CONTENT、MODERATE

Moderator

ADVERTISE、ANALYZE、MODERATE

在角色型權限完全由工作型權限取代之前，當透過 /page/roles 授予工作時，您必須授予角色所有的對等工作，否則 POST 作業將失敗。

為支援這些變更，perms 和 role 欄位已停用，並由新的 tasks 欄位取代。這會影響以下關係連線：

  • /me/accounts
  • /page/roles
  • /user/accounts

請參閱行銷 API 變更紀錄，以查看這些變更如何影響行銷 API 和企業管理平台 API。

Webhooks

這些變更適用於 3.1 以上版本，且將於 2018 年 10 月 24 日套用至所有版本。

下列的用戶 Webhook 欄位已停用：

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

下列的用戶 Webhook 欄位現在使用 HTTPS 網址，而非 HTTP。

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

這些欄位的網址也將過期：此將立即影響所有 API 版本。