Facebook 公共主页 API

通过 Facebook 公共主页 API，应用可以管理 Facebook 公共主页和使用具有必要权限的相关功能。使用此 API 可执行各种公共主页管理任务，如发布内容、读取成效分析、管理评论和接收实时更新。

关键组成部分：

• 访问口令：经过身份验证的具有必要权限的口令
• 端点：用于执行操作（发布、获取、更新、删除）
• Webhook：用于接收实时更新

身份验证和访问口令

与公共主页 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

Webhook

Webhook 提供与公共主页上的更改或事件相关的实时更新，如新的评论、赞或消息。

设置

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 参考文档
• Webhook

Facebook 公共主页 API

借助 Meta 的 Facebook 公共主页 API，应用可以访问和更新 Facebook 公共主页的设置及内容、创建和获取帖子、获取对公共主页自有内容的评论、获取公共主页成效分析、更新用户能够在公共主页上执行的操作等。

本文档包含您了解和实现 Facebook 公共主页 API 时会用到的指南。

文档内容

建议您按本文档概述的以下顺序阅读每份指南。

1. 概览 – 了解此公共主页 API 的组件和运作方式。
2. 创建应用 – 创建一个使用公共主页 API 用例的 Meta 应用。
3. 入门指南 – 此入门教程将向您展示如何在 Facebook 公共主页上发布帖子。
4. 管理公共主页 – 获取您的公共主页清单、您可在每个公共主页上执行的任务以及公共主页的访问口令，以及更新公共主页设置。
5. 帖子和评论 – 可创建、发布、更新和删除公共主页上的帖子和评论。
6. 公共主页成效分析 – 可获取对公共主页帖子的成效分析。
7. 公共主页搜索 – 可搜索公共主页。
8. 公共主页选项卡 – 可获取公共主页的选项卡清单。
9. Meta Webhook – 可获取发送到您服务器的有关您公共主页上所发生事件的实时通知。
10. 近期变更 – 可获取 Meta 将在您公共主页上实现的近期变更的相关通知。
11. 错误代码 – 可查看在实现公共主页 API 时您可能遇到的各类错误的错误代码和描述。
12. 更新日志 – 可查看公共主页 API 的变更日志。