图谱 API 参考文档
概览
Workplace 图谱 API 可用于以编程方式存取 Workplace 数据。这是一个基于 HTTP 的低级别 API，您可以用其查询有关 Workplace 图谱中的对象的数据。
图谱 API 得名于“图谱数据模型”理念，其中的对象由节点及相关联的连线表示。在 API 级别，这是应用访问 Workplace 中信息的方式。Workplace 图谱 API 支持图谱 API 的功能子集。此功能仅限与 Workplace 社群的互动，可能在某些情况下为提高性能或易用性而有所不同。
您可以在下方找到有关如何使用 Workplace 图谱 API 的更多信息：
创建应用构建智能助手权限示例使用图谱 API
图谱 API 对象
图谱 API 是 Workplace 中信息的表示方式，由以下部分组成：
- 节点 - 用户、照片、帖子或评论等对象
- 连线 - 上述元素之间的关联，例如帖子的文件或照片的评论
- 字段 - 关于对象的元数据，例如用户的姓名或小组的隐私设置
Workplace 图谱中每项内容均由独立编号表示。小组、成员、帖子，甚至评论都有其编号，这些编号可用于从图谱 API 中检索特定内容的相关信息。
管理社群
各个 Workplace 社群之间相互独立，您仅可以使用图谱 API 访问您所属社群中的内容，以及您所属社群的成员已加入的公司间合作小组中的内容。
为便于管理图谱 API 访问权限，您所属的社群会被视为小组。您可以将所属社群视为根小组，将其中所有小组添加为子组。如要在图谱 API 中检索关于您所属社群的信息，您将需要社群编号。您可以向 graph.facebook.com/community 发出 HTTP GET 请求，并提供有效的应用访问口令，从而以编程方式从图谱 API 检索此编号。
图谱 API 版本管理
Workplace 图谱 API 依托于图谱 API 而构建。这意味着，该 API 会继承相同的 API 版本管理行为。
图谱 API 版本每 3 个月左右发布一次，各个 Workplace API 和图谱 API 的更改将在图谱 API 更新日志中发布。
向图谱 API 发出 API 调用时，您可以在 API 路径中指定版本，如下所示：
https://graph.facebook.com/v2.11/community/groups
不过，可用版本也有一些限制：
- 新版本发布时，该版本将成为当前 API 版本，并保证在发布后 2 年内有效。
- 创建应用时，将默认使用创建时的当前 API 版本，此版本将成为该应用可用的最低 API 版本。
- 应用发出 API 调用时可以任意指定 API 版本，但无法向已停用的 API 版本或低于应用最低 API 版本的版本发出调用。
- 无版本号 API 调用将默认使用应用的最低 API 版本。
新的自定义集成创建后，系统会将其可用的最低 API 版本作为创建时的当前 API 版本。此最低版本将影响图谱 API 调用和 Webhooks 订阅。
开放平台版本管理图谱 API 更新日志查看图谱 API 版本
如果您不确定自己使用的是哪个版本，可以通过一些方式查看。如要查看您的应用支持使用哪些版本的图谱 API，可以向 API 调用添加 debug 参数。
https://graph.facebook.com/community?debug=all
这将额外返回调试信息，用以确认所使用的版本。
{
"name": "Example Community",
"privacy": "CLOSED",
"id": "855210357923606",
"__debug__": {
"messages": [
{
"link": "https://developers.facebook.com/docs/apps/versions/",
"message": "No API version was specified. This request defaulted to version v2.8.",
"type": "warning"
}
]
}
}
如果您尝试使用的版本低于应用的最低 API 版本，debug 消息将出现提示。
https://graph.facebook.com/v2.6/community?debug=all
{
"name": "Example Community",
"privacy": "CLOSED",
"id": "855210357923606",
"__debug__": {
"messages": [
{
"link": "https://developers.facebook.com/docs/apps/versions/",
"message": "The app tried to call version v2.6. This app can only call versions v2.8 and higher, so the request defaulted to version v2.8.",
"type": "warning"
}
]
}
}
查看 Webhooks 版本
如果 Webhooks 订阅是通过自定义集成弹出式对话框完成，或指定 API 版本的订阅是通过图谱 API 订阅端点 /app/subscriptions 完成，则 Webhooks 订阅使用最低 API 版本。
您可以使用订阅端点确认每个 Webhooks 字段和主题所应用的 Webhooks 版本。此端点需要应用访问口令。
https://graph.facebook.com/v2.11/app/subscriptions
{
"data": [
{
"object": "group",
"callback_url": "https://www.example.com/callback",
"active": true,
"fields": [
{
"name": "comments",
"version": "v2.8"
},
...
根据 Webhooks 订阅的启用方式，单个 Webhooks 对象中的不同字段可能使用不同版本号返回负载。
如果您的负载与您预期的格式不同，请仔细检查版本号，必要时使用较新版本重新订阅。