入门指南

本指南讲解了如何开始从 Facebook 社交关系图谱接收数据。

准备工作

您将需要:

您的第一个请求

第 1 步:打开图谱 API 探索工具

在新的浏览器窗口中打开图谱 API 探索工具。这样您便可边执行示例,边阅读此教程。

探索工具会加载默认查询,其中包括 GET 方法、最新版图谱 API、查询字符串字段中的 /me 节点与 idname 字段,以及您的 Facebook 应用。

第 2 步:生成访问口令

点击生成访问口令按钮。使用 Facebook 登录窗口随即弹出。在此弹窗中,您的应用会请求您授予从 Facebook 获取您的姓名和头像的权限。

此流程展示的是我们的 Facebook 登录产品,允许用户使用其 Facebook 凭证登录应用。通过 Facebook 登录,应用可请求用户以访问其 Facebook 数据,用户也可选择接受或拒绝访问。您的姓名和头像是公开数据,可让其他用户在 Facebook 上找到您,因此运行此请求并不需要其他要求。

点击以…的身份继续

用户访问口令随即创建。此口令包含如下信息:发出请求的应用、使用应用发出请求的用户、访问口令是否仍有效(大约一小时后到期)、到期时间,以及应用可请求的数据范围等。在此请求中,范围为 public_profile,其中包括您的姓名和头像。

点击访问口令旁的圆形信息图标,即可查看口令信息。

第 3 步:提交请求

点击右上角的提交按钮。

您应看到的内容

响应窗口中,您会看到包含您的 Facebook 用户编号和姓名的 JSON 响应。

若从查询字符串字段中移除 ?fields=id,name 并点击提交,您仍会看到相同结果,这是因为 nameid 是默认返回的用户节点字段。

您的第二个请求

第 1 步:添加字段

我们再添加一个字段 email,让第一个请求更复杂一些。添加字段的方式有以下两种:

  • 点击响应窗口左侧节点字段查看器中的搜索下拉菜单
  • 在查询字符串字段中输入内容。

添加 email 字段并点击提交

您应看到的内容

尽管调用并未失败,但系统只返回了 nameid 字段以及调试消息。点击“(显示)”链接以调试请求。

几乎所有节点和字段都需要特定权限才能访问。调试消息显示,您需要为应用提供相应权限,应用才能访问您与 Facebook 帐户关联的邮箱。

第 2 步:添加权限

在右侧面板的权限下,点击添加权限下拉菜单。点击用户数据权限,然后选择邮箱

生成新的用户访问口令

因为您要更改访问口令的范围,所以需要创建新的访问口令。点击生成访问口令。与第一个请求一样,您必须在 Facebook 登录对话框中为应用提供相应权限,应用才能访问您的邮箱。

创建新口令后,请点击提交。现在,请求中的所有字段都将返回。

尝试获取您的 Facebook 帖子。

查看详细步骤。

响应中的链接

请注意,响应窗口中返回的 id 值是链接。这些链接可以表示用户、公共主页或帖子等节点。如果点击这些链接,该编号 (id) 即会替换查询字符串字段的内容。现在,您可以在该节点运行请求。由于此节点连接至父节点(用户的帖子),您可能不需要添加权限。您现在可以点击帖子编号,因为我们将在下一个示例中用到该编号。

请注意:有些编号是父编号和新编号字符串的组合。例如,用户的帖子编号可以如下所示:1028223264288_102224043055529,其中 1028223264288 为用户编号。

我们来看看连线

用户节点并没有很多可以返回数据的连线。只有拥有用户对象的用户才能授予对相应对象的访问权限。大多数情况下,用户创建对象后即可拥有该对象。

例如,发布一条帖子后,您即可查看该帖子的相关信息,如帖子的创建时间,帖子中分享的文字、照片和链接,以及帖子收到的心情数量。如果您评论自己的帖子,您将能获取该评论;但如果其他人对您的帖子发表评论,您将看不到该评论或发表该评论的用户。

尝试获取您其中一条帖子的心情数量。您可以查看

对象心情参考文档

查看详细步骤。

获取请求代码

探索工具可用于测试请求,响应成功后,您即可获取代码并将其插入应用代码中。点击响应窗口底部的获取代码。探索工具提供 Android、iOS、JavaScript、PHP 和 cURL 代码。代码已预先选中,您只需复制粘贴即可。

建议您为应用实现 Facebook SDK。此 SDK 将包含 Facebook 登录,可让您的应用请求权限并获取访问口令。

详细了解

您可以使用图谱 API 探索工具测试用户、公共主页和小组等的任何请求。请查看各节点或连线的参考文档,以确定所需的权限和访问口令类型。