入门指南

本文档将说明如何成功调用公共主页 API 以发布至您的公共主页。

准备工作

您需要具备以下条件：

• 未发布或已发布的 Facebook 公共主页，而且您可以在该公共主页上执行 CREATE_CONTENT 任务。
• 该公共主页的公共主页访问口令
• 以下权限：

  • pages_manage_metadata
  • pages_manage_posts
  • pages_manage_read_engagement
  • pages_show_list

最佳实践

第 1 步：获取您的公共主页编号

如需获取您可以执行任务的 Facebook 公共主页的编号和公共主页访问口令清单，请向 /user_id/accounts 端点发送 GET 请求，其中 user_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 参数设为公共主页访问口令：

请求示例

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 请求：

请求示例

      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"  
    },
...
  ]
}

使用图谱探索工具

图谱探索工具是一个用户界面，您可以借助此用户界面在不向应用或网站添加代码的情况下尝试使用 Facebook API。您可以选择权限，获取访问口令，测试 GET、POST，以及 DELETE 方法，并获取用于 Android、iOS、JavaScript、PHP 和 cURL 查询的代码片段。

请注意，如需使用图谱探索工具，您需要拥有 Facebook 应用编号。

第 1 步：获取您的公共主页编号

选择任何出现在权限下拉菜单下的 pages_manage_metadata、pages_manage_posts、pages_manage_read_engagement，和 pages_show_list 权限，在查询对话框中将 GET 请求设置为 /me/accounts 端点，然后点击提交。

点击显示在您的公共主页名称正下方的公共主页编号，将该编号移到查询对话框中。

第 2 步：以公共主页身份发帖

在用户或公共主页下拉菜单下，为您的公共主页选择公共主页访问口令。然后，将方法设置为 POST，并向 /{page-id}/feed 端点发出请求，然后将 Paramskey 设置为 message，并将 value 设置为您的帖文。点击提交。

成功后，图谱探索工具将显示该公共主页帖子编号。

访问您的 Facebook 公共主页以查看帖子。

第 3 步：验证您的帖子

向 GET 端点发送 /page-id/feed 请求：

若请求成功，图谱探索工具将显示帖子的创建时间、帖子文本以公共主页帖子编号。

后续步骤

浏览管理 Facebook 公共主页指南，了解如何获取和更新您 Facebook 公共主页的相关信息，包括公共主页详情、访问口令、已拉黑的用户以及用户推荐。

了解如何向您的公共主页发布链接、照片和视频。

另请参阅