總覽

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

元件

存取權杖

API 驗證是透過存取權杖進行處理。大部分端點都需要粉絲專頁存取權杖,每個粉絲專頁、應用程式用戶和應用程式皆有專屬的粉絲專頁存取權杖和到期時間。若要取得應用程式用戶的權杖,應用程式用戶必須擁有或能夠在粉絲專頁上執行工作。

您可以透過實作「Facebook 登入」來取得應用程式用戶的存取權杖。

針對已移轉至「新版粉絲專頁體驗」的粉絲專頁,現在除了下列端點之外,所有可用端點都需要粉絲專頁存取權杖:

圖形 API

如果您還不熟悉圖形 API,請先閱讀我們的圖形 API 文件,再繼續深入瞭解 Meta 社交關係圖。

Facebook 登入

「Facebook 登入」可讓應用程式用戶登入您的應用程式,並可讓您的應用程式要求用戶提供存取資料的權限。

商家專用 Facebook 登入

對於需要存取商家客戶資產的技術供應商和商業應用程式開發人員而言,「商家專用 Facebook 登入」是廣受喜愛的驗證和授權解決方案

功能

部分端點所需的功能必須通過應用程式審查程序核准,當您的應用程式上線時,才能使用這些功能。功能允許您在不具權限或無法在粉絲專頁執行工作的情況下,存取公開粉絲專頁資料。請參閱每個端點的參考資料,以判斷其所需的粉絲專頁功能。

提及

「@提及」可讓您的粉絲專頁公開回覆在您的粉絲專頁上發佈貼文,或在粉絲專頁貼文的留言或回覆中留言的特定用戶。

粉絲專頁範圍用戶編號

粉絲專頁範圍用戶編號(PSID)可識別與粉絲專頁互動的用戶。PSID 是每個用戶粉絲專頁配對的專屬編號。粉絲專頁 API 和 Messenger 開放平台端點依賴 PSID,因此您可以使用 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 發佈粉絲專頁貼文。