新手指南

本文件將說明如何成功呼叫專頁 API 以發佈至您的專頁。

準備工作

您需要準備好以下項目:

  • Facebook 專頁,這可以是未發佈或已發佈的專頁,而您需要能夠在此專頁上執行 CREATE_CONTENT 任務。
  • 專頁的專頁存取憑證
  • 以下權限:
    • pages_manage_metadata
    • pages_manage_posts
    • pages_manage_read_engagement
    • pages_show_list

最佳操作實例

測試 API 呼叫時,您可以在呼叫中加入 access_token 參數,並將其設為您的存取憑證。但是,從您的應用程式發出安全呼叫時,應使用存取憑證類別

步驟 1:取得您的專頁編號

如要取得您可執行任務的 Facebook 專頁之編號和專頁存取憑證清單,請向 /user_id/accounts 端點傳送 GET 要求,其中 user_id 是您的用戶編號。

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值(如 page_id)替換為您的值。
curl -i -X GET "https://graph.facebook.com/v21.0/user_id/accounts?access_token=user_access_token"

成功的話,您的應用程式就會收到以下 JSON 回應,其中包含物件陣列。每個物件都包含特定專頁的資料,其中包括名稱、編號、短期專頁存取憑證、您可在專頁上執行的任務等:

{
  "data": [
    {
      "access_token": "page_access_token",
      "category": "Internet Company",
      "category_list": [
        {
          "id": "2256",
          "name": "Internet Company"
        }
      ],
      "name": "Name of this Page",
      "id": "page_id",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT"
      ]
    },
...

步驟 2:發佈帖子

如要發佈帖子,請向 /page_id/feed 傳送 POST 要求,其中 page_id 是發佈目標專頁的編號,並需要將 message 參數設為訊息內容,再將 access_token 參數設為專頁存取憑證:

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值(如 page_id)替換為您的值。
curl -X POST "https://graph.facebook.com/v21.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "access_token":"page_access_token",
         }'

您的帖子將會立即發佈。

成功的話,您的應用程式就會收到以下 JSON 回應,其中包含帖子編號:

{
  "id": "page_post_id" 
}

瀏覽您的 Facebook 專頁 以查看帖子。

步驟 3:驗證您的帖子

如要驗證您的帖子是否已經發佈,請向 /page_id/feed 端點傳送 GET 要求:

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值(如 page_id)替換為您的值。
      curl -i -X GET "https://graph.facebook.com/v21.0/page_id/feed?access_token=page_access_token"

成功的話,您的應用程式就會收到以下 JSON 回應,其中包含物件陣列。每個物件都包含帖子編號、訊息內容和帖子建立時間:

{
  "data": [
    {
      "created_time": "2020-03-25T17:33:34+0000",
      "message": "Hello World!",
      "id": "422575694827569_917077345377399"  
    },
...
  ]
}

使用 Graph 測試工具

Graph 測試工具是一個用戶介面,允許您嘗試使用 Facebook API,而無需在應用程式或網站新增程式碼。您可以選擇權限,取得存取憑證,測試 GETPOST,以及 DELETE 方法,以及獲取用於 Android、iOS、JavaScript、PHP 和 cURL 此等查詢的程式碼片段。

請注意,如需使用 Graph 測試工具,您需要有 Facebook 應用程式編號

步驟 1:取得您的專頁編號

選擇出現在「權限」下拉式選單中的 pages_manage_metadatapages_manage_postspages_manage_read_engagementpages_show_list 權限,在查詢對話方塊中將 GET 要求設定為 /me/accounts 端點,然後點擊「提交」。

點擊顯示在專頁名稱正下方的專頁編號,將該編號移到查詢對話方塊中。

步驟 2:以專頁身分發佈內容

在「用戶或專頁」下拉式選單下,為您的專頁選擇專頁存取憑證。接下來,將方法設定為 POST,並向 /{page-id}/feed 端點發出要求,然後將 Paramskey 設定為 message,將 value 設為您的帖子文字。點擊提交

成功後,Graph 測試工具將顯示該專頁帖子的編號。

瀏覽您的 Facebook 專頁以查看帖子。

步驟 3:驗證您的帖子

傳送 GET 要求至 /page-id/feed 端點。

成功的話,Graph 測試工具會顯示帖子的建立時間、帖子文字及專頁帖子編號。

後續步驟

使用管理 Facebook 專頁指南,了解如何取得並更新 Facebook 專頁的資料,其中包括專頁詳情、存取憑證、已封鎖的用戶和用戶建議。

了解如何在專頁發佈連結、相片及影片