概覽

專頁 API 是一組 Facebook Graph API 端點,可供應用程式用於建立和管理專頁的設定和內容。

元件

存取憑證

系統透過存取憑證處理 API 驗證。大多數端點都需要專頁存取憑證,這些憑證根據每個專頁、應用程式用戶和應用程式而異,而且設有到期時間。若要向應用程式用戶獲取憑證,應用程式用戶必須在專頁上擁有或者能夠執行任務。

您可以透過執行 Facebook 登入來向應用程式用戶獲取存取憑證。

對於已轉移至新版專頁體驗的專頁,其所有可用端點現均需要提供專頁存取憑證才能使用,惟以下例外情況除外:

Graph API

如果您不熟悉 Graph API,請在繼續之前查閱我們的 Graph API 文件,以進一步了解 Meta 社交關係圖。

Facebook 登入

Facebook 登入允許應用程式用戶登入您的應用程式,以及讓應用程式向用戶要求獲取數據存取權限。

商家專用 Facebook 登入

對於需要獲取企業客戶資產存取權限的技術供應商和商業應用程式開發人員來說,商家專用 Facebook 登入功能是執行驗證和授權的首選解決方案

功能

部分端點需要使用的功能必須先經應用程式審查程序批准,之後才能供您的應用程式在已發佈模式下使用。功能讓您在沒有權限或無法在專頁上執行任務的情況下,都可存取公開的專頁資料。請參閱每個端點的參考資料,以確定各端點分別需要哪些專頁功能。

提及功能

@提及允許您的專頁在留言或回覆中,對曾在您專頁發佈內容或在您專頁帖子留言的特定用戶作出公開回應。

專頁範圍用戶編號

專頁範圍用戶編號 (PSID) 可用來識別與專頁互動的用戶。PSID 是指個別用戶與專頁之間的編號,每次配對的編號均為不重複。專頁 API 和 Messenger 平台端點都會使用 PSID,以便您透過此編號識別用戶與專頁的互動,以及用戶與該專頁的公開 Messenger 對話。

權限

大多數端點都需要一種或多種權限,且必須是由應用程式用戶向您的應用程式授予有關權限。您通常可以透過 Facebook 登入程序取得有關權限,而如果您的應用程式已由企業認領,則亦可透過企業管理平台取得權限。

所有權限都必須先通過應用程式審查,然後應用程式用戶才能在您的應用程式處於已發佈模式後向其授予權限。由於商業應用程式並不設有應用程式模式,您必須就所需的權限先獲准取得進階存取權限,這樣在應用程式本身或已認領應用程式的企業中沒有角色的應用程式用戶方可向您的應用程式授予有關權限。

專頁搜尋

尋找有關 Facebook 專頁的資訊(包括名稱和地點),以及尋找要@提及的專頁、專頁地點及標註專頁以展示品牌置入內容。

限速限制

所有專頁端點要求都需遵守限速限制。您可以在應用程式管理中心中查看應用程式目前的呼叫使用次數。

任務

任務允許用戶在專頁上執行特定動作。當用戶使用應用程式與專頁互動時,我們將根據其嘗試執行的動作,首先檢查用戶是否已獲准執行允許有關動作類型的任務。

您可以批准個別用戶執行以下任務:

任務允許執行的動作

ADVERTISE

  • 建立廣告
  • 建立贊助式專頁帖子
  • 如果專頁已與 Instagram 帳戶連結,則可建立相應廣告

ANALYZE

  • 查看專頁洞察報告
  • 查看哪個專頁管理員發佈了帖子或回應

CREATE_CONTENT

  • 以專頁身分於專頁上發佈內容

MANAGE

  • 分配和管理專頁任務

MANAGE_LEADS

  • 查看和管理潛在顧客

MESSAGING

  • 以專頁身分傳送訊息

MODERATE

  • 以專頁身分回覆專頁帖子上的回應
  • 刪除專頁帖子上的回應
  • 如果專頁已與 Instagram 帳戶連結,則可從 Facebook 發佈內容至 Instagram、回覆和刪除回應,傳送 Direct 訊息、同步企業聯絡資料,以及建立廣告。

VIEW_MONETIZATION_INSIGHTS

  • 查看營利洞察報告

如果用戶在用戶介面中獲授予專頁管理員權限,便可以在該專頁上執行所有任務。

Messenger 平台

在 Messenger 上與您的顧客或對您專頁感興趣的用戶展開對話。

Meta 專頁 Webhooks

當用戶在專頁帖子留言或向專頁帖子表達心情時取得即時通知。

應用程式審查

所有與專頁相關的權限和功能必須先經應用程式審查程序批准,之後才能供您的應用程式在已發佈模式下使用。

處於開發模式的應用程式可以向擁有應用程式角色的任何應用程式用戶要求任何權限。

運作方式

存取專頁 API 的一般流程如下:

  1. 透過 Facebook 登入向應用程式用戶獲取用戶存取憑證。
  2. 查詢 /me/accounts 端點,以根據應用程式用戶允許應用程式存取的專頁來獲取有關專頁的編號和專頁存取憑證。
  3. 擷取傳回的專頁編號和專頁存取憑證。
  4. 使用該編號和憑證查詢專頁節點。

請注意,在某些情況下,應用程式用戶可能會授權應用程式存取多個專頁。在這種情況下,您應該擷取每個專頁編號及其相應憑證,並提供方法來讓應用程式用戶鎖定當中各個專頁。

後續步驟

請按照我們的新手入門指南操作,了解如何使用專頁 API 發佈專頁帖子。