概览

Google API Explorer 是一款在大多数 REST API 方法文档页面上提供的工具，可让您在不编写代码的情况下试用 Google API 方法。API Explorer 会对真实数据执行操作，因此请在尝试创建、修改或删除数据的方法时要小心谨慎。

使用目录

如需查看可浏览的 Google API 列表，请浏览 Google API Explorer 目录。此列表包含指向受支持 API 的 API 参考文档的链接。请按照以下步骤探索该 API：

  1. 打开 Google API Explorer 目录。
  2. 在顶部的搜索框中，输入您要探索的 API 的名称。
  3. 点击 API 的名称。系统随即会打开 API 参考文档。
  4. 在左侧，点击您要在导航中使用的方法。

  5. 在右侧，找到标有“试用此方法”的面板。请参阅下文，详细了解如何使用 API Explorer 侧边栏以及如何将其展开至全屏 API Explorer 面板。

使用侧边栏

适用于 Google Books API 的 APIs Explorer 侧边栏
图 1：Google Books API 的 APIs Explorer 侧边栏。

默认情况下，API Explorer 会显示在屏幕右侧的 API 参考文档中，适用于受支持的方法。

您可以在 API Explorer 侧边栏中自定义以下部分并与之互动：

  • 请求参数（如果该方法需要）。
  • 请求正文（如果该方法需要的话）。
  • 凭据，用于测试具有各种凭据类型和范围的方法。
  • Execute 按钮，以使用您指定的参数和设置运行该方法。
  • 结果，仅在执行该方法后显示。

使用全屏面板

适用于 Google Books API 的 APIs Explorer 全屏面板
图 2：适用于 Google Books API 的 APIs Explorer 全屏面板。

在收起的 APIs Explorer 侧边栏中，您可以点击“全屏”图标 展开 APIs Explorer。全屏面板会显示一个额外的窗格，其中包含代码示例、application/json 响应和原始 HTTP 响应。

身份验证

API Explorer 使用自己的凭据发出请求。您无法在 API Explorer 中使用自定义凭据。

数据格式

API Explorer 仅支持响应和请求载荷的 JSON。即使您的 API 支持其他数据格式，这些格式也无法在 API Explorer 中使用。

后续步骤