概览

公共主页 API 是一组 Facebook 图谱 API 端点，应用可将其用于创建和管理公共主页的设置与内容。

组件

访问口令

系统通过访问口令处理 API 身份验证。大多数端点都需要公共主页访问口令。每个公共主页、应用用户和应用的公共主页访问口令都是唯一的，而且具有有效期。如要从应用用户处获取口令，该应用用户必须在相关公共主页上拥有任务，或能够执行任务。

您可以通过实现 Facebook 登录从应用用户处获取访问口令。

图谱 API

如果您不熟悉图谱 API，请先阅读我们的图谱 API 文档，然后再继续详细了解 Meta 社交关系图谱。

Facebook 登录

Facebook 登录允许应用用户登录您的应用，并允许该应用请求用户授予访问数据的权限。

企业版 Facebook 登录

对于需要获取业务客户资产访问权限的技术代理和业务应用开发者，企业版 Facebook 登录是执行身份验证和授权的首选解决方案

功能

一些端点要求使用的功能必须先通过应用审核流程批准，您的应用才能在上线后使用这些功能。通过功能，您可以在没有权限或无法在公共主页中执行任务的情况下，访问公开的公共主页数据。请参阅各个端点的参考资料，确定各端点要求使用哪种公共主页功能。

提及

通过 @提及，您的公共主页可以在评论或回复中，公开回复在您公共主页上发帖或评论您公共主页帖子的特定用户。

公共主页范围用户编号

与公共主页互动的用户由公共主页范围用户编号 (PSID) 进行标识。PSID 是每个用户-公共主页对的唯一编号。公共主页 API 和 Messenger 开放平台端点使用 PSID，因此您可以使用 PSID 识别用户与公共主页的互动，以及用户与该公共主页的公开 Messenger 对话。

权限

大多数端点都要求一种或多种权限，这些权限必须由应用用户向应用授予。通常来说，此授权可通过 Facebook 登录完成；但如果您的应用已由公司认领，此授权也可通过商务管理平台完成。

所有权限都需要先经过应用审核，应用用户才能在应用上线后向应用授予这些权限。业务应用不具备应用模式，则必须先获得权限的高级访问级别，在应用中或已认领应用的公司中没有身份的用户才能向该应用授予这些权限。

公共主页搜索

可查找有关 Facebook 公共主页的信息（包括名称和位置），查找要 @提及的公共主页和公共主页的位置，并标记一个公共主页以显示品牌内容。

流量限制

所有公共主页端点请求均受到流量限制。您可以在应用面板中查看应用当前已使用的调用次数。

任务

通过任务，用户可以在公共主页上执行特定操作。当用户使用应用与公共主页互动时，我们将根据要尝试的操作，首先检查该用户是否已获准执行允许该类操作的任务。

您可以批准个人用户执行以下任务：

如果用户在用户界面中获得某个公共主页的管理员访问权限，该用户将能够在该公共主页上执行所有任务。

Messenger 开放平台

通过 Messenger 与您的客户或对您的公共主页感兴趣的用户展开对话。

公共主页专用 Meta Webhooks

当用户评论公共主页帖子或给公共主页帖子留下心情时，可接收实时通知。

应用审核

公共主页相关的所有权限和功能都必须先通过应用审核流程批准，您的应用才能在上线后使用这些功能。

处于开发模式的应用可以向在应用中拥有身份的任意应用用户请求任意权限。

运作方式

以下是访问公共主页 API 的典型流程：

1. 通过 Facebook 登录从应用用户处获取用户访问口令。
2. 查询 /me/accounts 端点，以获取应用用户已允许您应用访问的公共主页的编号和公共主页访问口令。
3. 获取返回的公共主页编号和公共主页访问口令。
4. 使用该编号和口令查询公共主页节点。

请注意，在某些情况下，应用用户可能会为您的应用授予多个公共主页的访问权限。在这种情况下，您应该获取每个公共主页编号及各自的口令，并提供方法来帮助应用用户定位到其中的各个公共主页。

后续步骤

请遵循我们的入门指南，了解如何使用公共主页 API 发布公共主页帖子。

另请参阅