图谱 API 探索工具指南

常见用途

• 快速生成访问口令
• 为查询获取代码示例
• 生成要加入支持请求的调试信息
• 使用生产版应用设置（包括权限、功能和用例设置）测试 API 查询
• 使用模拟用户或测试数据的权限和功能，以测试版或开发版应用测试 API 查询

要求

• Facebook 开发者帐户
• 对特定应用拥有管理员、开发者或测试者等身份

组件

访问口令

如果您获得访问口令，该口令会显示在此工具的右上角。您要在图谱 API 查询中加入访问口令。您可以复制此口令，并在应用中用它来测试代码。

点击信息图标即可查看当前口令的相关信息，包括口令关联的应用，以及由应用用户（您自己）授予的任何权限。

如果口令已过期或您添加了新权限，您可以生成新的访问口令。

Meta 应用

右上角的“Meta 应用”下拉菜单会显示您拥有管理员、开发者或测试者身份的全部应用。使用该下拉菜单选择您想要测试的应用设置。

用户或公共主页

通过“用户或公共主页”下拉菜单，您可以获取并替换当前所选应用的应用访问口令、用户访问口令以及公共主页访问口令。您也可以使用该菜单从用户节点卸载应用，但这会损毁当前访问口令。

权限

每当您请求用户访问口令时，系统默认只提供一项权限：public_profile。您可通过“权限”下拉菜单选择用户数据权限（如 email 和 user_photos 权限）、活动、小组、公共主页权限（如 manage_pages 和 ads_management 权限），以及其他权限（如 instagram_basic 和 publish_video 权限）。如此一来，当前应用用户（您自己）便可授予应用特定权限。您只需授予应用实际需要的权限。

如果您的应用处于开发模式，您可以授予该应用任何权限，并且您的查询也会遵守这些权限，以便获取在此应用中拥有身份的用户所拥有的数据。但是，如果您的应用处于上线模式，当您向该应用授予未经应用审核流程批准的权限时，无论您何时提交查询，这都会导致您的查询失败。

查询字符串栏

在您首次进入此工具时，系统会显示一个默认查询。您可以编辑查询，方法如下：输入新查询；或在执行查询后，在字段查看器中搜索并选择字段。您也可以使用下拉菜单切换运算方法，并将目标设置为图谱 API 的不同版本。

如果您点击查询栏末尾的星标，则系统会将此查询保存为常用查询。您可以通过点击书籍图标来查看常用查询。

节点字段查看器

当您在节点上提交 GET 查询时，窗口左侧的字段查看器会显示节点名称以及由图谱 API 返回的字段。如要修改查询，您可以搜索和选择新字段，点击加号图标并从可用字段中选择，或取消勾选不必要的字段。这些操作会在查询字符串栏中动态更新您的查询。

响应窗口

查询字符串下方的响应将显示您上次提交的查询所返回的结果。

获取代码

如果您对查询满意，则点击响应下方底部中间的“获取代码”按钮，以生成基于查询的代码示例。通常，您不能直接在代码基中复制和粘贴代码示例，但您可将它用作实用参考。

复制调试信息

如果查询持续失败，但您无法找到原因，并决定联系开发者支持团队，则可以点击底部中间的“复制调试信息”按钮，将查询和响应详细信息复制到剪贴板。您可以将此信息连同支持请求一起提交给我们，帮助我们了解问题。

保存会话

点击底部中间的“保存会话”按钮，即可在移除访问口令的情况下保存您的查询状态。如果您决定联系开发者支持团队，请提供指向此会话的链接。

查询示例

尝试执行在您首次加载图谱 API 探索工具时出现的默认查询。如果您尚未加载过图谱 API 探索工具，请在新窗口中打开图谱 API 探索工具，从“应用程序”下拉菜单中选择您想要测试的应用，并获取用户访问口令。

查询字符串栏中会显示默认查询：

GET https://developers.facebook.com/v19.0/me?fields=id,name

默认查询正在 /me 节点上请求 id 和 name 字段，该节点是特殊节点，会映射到 /User 或 /Page 节点（根据口令确定）。由于您正在使用用户访问口令，这会映射到您的用户节点。

id 和 name 字段皆可公开获取，如果用户已向您的应用授予 default 或 public_profile 权限，则系统会返回这两个字段。这些权限都经过预先批准，可供所有应用使用（您可以通过点击访问口令栏中的信息图标来确认这一点），因此您无需向应用授予任何额外权限，即可使查询生效。点击获取访问口令，然后确认您想为应用授予您公开可用用户信息的访问权限。

提交查询后，您应该会看到您的应用范围用户编号和名称出现在响应窗口中。