Facebook 粉絲專頁 API

Facebook 粉絲專頁 API 允許應用程式管理 Facebook 粉絲專頁，並使用必要權限存取相關功能。此 API 可執行各種粉絲專頁管理任務，例如發佈內容、讀取洞察報告、管理留言以及接收即時更新資訊。

主要元件：

• 存取權杖：具備必要權限的驗證權杖
• 端點：用於執行操作（發佈、取得、更新、刪除）
• Webhooks：用於接收即時更新資訊

驗證和存取權杖

若要與粉絲專頁 API 互動，您需要粉絲專頁存取權杖。此權杖是透過用戶驗證而獲得，並授予權限以粉絲專頁的身分執行 API 動作。

產生粉絲專頁存取權杖

1. 應用程式向用戶要求必要權限。
2. 用戶授權給應用程式。
3. 應用程式將授權碼交換成用戶存取權杖。
4. 應用程式使用該權杖來要求粉絲專頁存取權杖。

權限和功能

不同的端點需要不同的權限：

• pages_show_list - 顯示用戶管理的粉絲專頁
• pages_read_engagement - 讀取發佈在粉絲專頁的內容
• pages_manage_posts - 發佈和排程內容
• pages_manage_engagement - 管理留言、刪除貼文
• pages_read_user_content - 在粉絲專頁讀取用戶產生的內容
• pages_manage_metadata - 管理粉絲專頁的設定
• pages_manage_ads - 建立和管理粉絲專頁的廣告
• pages_manage_cta - 檢視和更新行動呼籲按鈕
• pages_messaging - 代表粉絲專頁管理和傳送訊息
• business_management - 管理與粉絲專頁相關的商家資產

API 端點

粉絲專頁資訊

擷取粉絲專頁的基本資訊。

要求：

GET /<PAGE_ID>?fields=id,name,about,fan_count

權限：pages_show_list、pages_read_engagement

發佈內容

在粉絲專頁建立新貼文。

要求：

POST /{page-id}/feed

參數：

• message
• link
• picture
• published

權限：pages_manage_posts

  
POST /{page-id}/feed
Body:
{
message: "Hello from the Pages API!"
}

留言管理

讀取、建立和管理粉絲專頁貼文的留言。

讀取留言：

GET /{object-id}/comments

發佈留言：

POST /{object-id}/comments

刪除留言：

DELETE /<COMMENT_ID>

權限：pages_manage_engagement

洞察報告

取得粉絲專頁的分析和衡量指標。

要求：

GET /{page-id}/insights?metric=page_impressions,page_fans

權限：pages_read_engagement

提及

擷取提及該粉絲專頁的貼文或留言。

要求：

GET /{page-id}/tagged

權限：pages_read_user_content

粉絲專頁設定

更新或擷取粉絲專頁設定，例如封面相片、說明或訊息偏好設定。

取得設定：

GET /{page-id}?fields=cover,about,description

更新設定：

POST /{page-id}/settings

權限：pages_manage_metadata

Webhooks

Webhooks 提供粉絲專頁變更或活動的即時更新資訊，例如新留言、讚或訊息。

設定

1. 在開發人員主控板中配置回呼網址。
2. 訂閱必要欄位（例如：feed、mentions、messages）。
3. 您的服務將會收到相關事件的 HTTP POST 通知。

應用程式審查和發佈

如果您的應用程式需要延伸權限（最多粉絲專頁管理功能），則需要 Facebook 應用程式審查。

審查步驟

1. 在開發人員主控板中要求必要權限。
2. 提供詳細的使用案例和螢幕錄影影片。
3. 提交審查並回覆意見回饋。

要求範例

發佈訊息

取得貼文洞察報告

管理留言

• 刪除留言：

錯誤處理

• 使用 Facebook 錯誤代碼和訊息來確認問題。
• 常見錯誤：權杖無效、缺少權限、限速。
• 參考資料：https://developers.facebook.com/docs/graph-api/using-graph-api/error-handling/

最佳作法

• 使用最少的必要權限。
• 可以的話，請快取回應。
• 處理大量結果集的分頁。
• 尊重用戶隱私和 Facebook 政策。

參考資料

• Facebook 粉絲專頁 API 文件
• API 參考資料
• Webhooks

Facebook 粉絲專頁 API

Meta 的 Facebook 粉絲專頁 API 可讓應用程式存取和更新 Facebook 粉絲專頁的設定和內容、建立和取得貼文、取得粉絲專頁擁有之內容的留言、取得粉絲專頁洞察報告、更新用戶能夠在粉絲專頁執行的動作等。

本文件包含可幫助您瞭解及實作 Facebook 粉絲專頁 API 的指南。

文件內容

建議您按照下列順序閱讀本文件說明的各項指南。

1. 總覽 – 瞭解粉絲專頁 API 的元件和運作方式。
2. 建立應用程式 – 使用粉絲專頁 API 使用案例建立 Meta 應用程式。
3. 新手指南 – 說明如何發佈貼文至 Facebook 粉絲專頁的入門教學導覽。
4. 管理粉絲專頁 – 取得粉絲專頁清單（包含您可以在各粉絲專頁上執行的任務和粉絲專頁存取權杖），以及更新粉絲專頁設定。
5. 貼文和留言 – 建立、發佈、更新和刪除粉絲專頁貼文和留言。
6. 粉絲專頁洞察報告 – 取得粉絲專頁貼文的洞察報告。
7. 粉絲專頁搜尋 – 搜尋粉絲專頁。
8. 粉絲專頁頁籤 – 取得粉絲專頁的頁籤清單。
9. Meta Webhooks – 取得傳送至伺服器的即時通知，以瞭解粉絲專頁發生的事件。
10. 近期變更 – 針對 Meta 將對粉絲專頁實施的近期變更，取得相關通知。
11. 錯誤代碼 – 針對您在實作粉絲專頁 API 時可能發生的錯誤，查看錯誤代碼及其說明。
12. 變更紀錄 – 查看粉絲專頁 API 的變更紀錄。