本指南讲解了如何开始从 Facebook 社交关系图谱接收数据。
您将需要:
在新的浏览器窗口中打开图谱 API 探索工具。这样您便可边执行示例,边阅读此教程。
探索工具会加载默认查询,其中包括 GET
方法、最新版图谱 API、查询字符串字段中的 /me
节点与 id
和 name
字段,以及您的 Facebook 应用。
点击生成访问口令按钮。使用 Facebook 登录窗口随即弹出。在此弹窗中,您的应用会请求您授予从 Facebook 获取您的姓名和头像的权限。
此流程展示的是我们的 Facebook 登录产品,允许用户使用其 Facebook 凭证登录应用。通过 Facebook 登录,应用可请求用户以访问其 Facebook 数据,用户也可选择接受或拒绝访问。您的姓名和头像是公开数据,可让其他用户在 Facebook 上找到您,因此运行此请求并不需要其他要求。 点击以…的身份继续 用户访问口令随即创建。此口令包含如下信息:发出请求的应用、使用应用发出请求的用户、访问口令是否仍有效(大约一小时后到期)、到期时间,以及应用可请求的数据范围等。在此请求中,范围为 |
点击访问口令旁的圆形信息图标,即可查看口令信息。 |
点击右上角的提交按钮。
在响应窗口中,您会看到包含您的 Facebook 用户编号和姓名的 JSON 响应。
若从查询字符串字段中移除 ?fields=id,name
并点击提交,您仍会看到相同结果,这是因为 name
和 id
是默认返回的用户节点字段。
我们再添加一个字段 email
,让第一个请求更复杂一些。添加字段的方式有以下两种:
添加 email
字段并点击提交。
尽管调用并未失败,但系统只返回了 name
和 id
字段以及调试消息。点击“(显示)”链接以调试请求。
几乎所有节点和字段都需要特定权限才能访问。调试消息显示,您需要为应用提供相应权限,应用才能访问您与 Facebook 帐户关联的邮箱。
在右侧面板的权限下,点击添加权限下拉菜单。点击用户数据权限,然后选择邮箱。 生成新的用户访问口令因为您要更改访问口令的范围,所以需要创建新的访问口令。点击生成访问口令。与第一个请求一样,您必须在 Facebook 登录对话框中为应用提供相应权限,应用才能访问您的邮箱。 创建新口令后,请点击提交。现在,请求中的所有字段都将返回。 |
尝试获取您的 Facebook 帖子。
请注意,响应窗口中返回的 id
值是链接。这些链接可以表示用户、公共主页或帖子等节点。如果点击这些链接,该编号 (id) 即会替换查询字符串字段的内容。现在,您可以在该节点运行请求。由于此节点连接至父节点(用户的帖子),您可能不需要添加权限。您现在可以点击帖子编号,因为我们将在下一个示例中用到该编号。
请注意:有些编号是父编号和新编号字符串的组合。例如,用户的帖子编号可以如下所示:1028223264288_102224043055529
,其中 1028223264288
为用户编号。
探索工具可用于测试请求,响应成功后,您即可获取代码并将其插入应用代码中。点击响应窗口底部的获取代码。探索工具提供 Android、iOS、JavaScript、PHP 和 cURL 代码。代码已预先选中,您只需复制粘贴即可。
建议您为应用实现 Facebook SDK。此 SDK 将包含 Facebook 登录,可让您的应用请求权限并获取访问口令。