Google APIs 发现服务：只需一个 API 即可找到所有 API

如 Google I/O  2010 所宣布的，新系列的 Google APIs 客户端库运行在一个全新的 API 架构之上，允许 Google 降低发布与维护客户端库所需的工作量。该架构是通过一个简单的 API 实现的，它提供了机器可读的 Google APIs 描述，客户端库可以利用这些信息与所有 API 交互。

今天发布的 Google APIs 发现服务就是新版客户端库背后的秘密武器。该服务提供关于 Google APIs 的机器可读的元数据，包括：

• 支持的 API 目录。
• 各支持 API 的“发现文档”，包括：
  • 基于 JSON Schema 的 API 资源纲要列表。
  • API 方法列表，及各方法可用的参数。
  • 可用的 OAuth 2.0 权限（scope）列表。
• 行内的方法、参数以及可用参数值文档。

该服务可通过轻量级的基于 JSON 的 API 访问。请转至 https://www.googleapis.com/discovery/v1/apis 看看有哪些数据可用。

您可以使用 APIs 发现服务创建用于与 Google APIs 交互的工具，如 IDE 插件和客户端库。Google 自己就采用该服务创建了一些这类工具：

• Google APIs 客户端库——如上所述
• Google APIs Explorer——互动性基于 web 的 Google APIs 探索工具
• Google Plugin for Eclipse 中的 Google API 支持——一项 IDE 整合，允许直接将 Google APIs 支持导入到 Eclipse 项目中

在发布该服务的同时，Google 同时开放了 APIs Explorer 的源代码，可作为如何使用这些服务的很好的例子。

关于 Google APIs 发现服务的详情可参阅文档，或者在 APIs Explorer 中探索其 API。本届 Google I/O 上还有“构建自定义 Google APIs  客户端库”的议程，感兴趣的同学可前往 YouTube 观看录像。

via Google Code Blog