前提条件

如果您尚未完成一些准备工作,请先完成,然后才能开始编写您的第一个客户端应用。

获取 Google 账号

您需要 Google 账号以获取在 Google API 控制台中访问 Compute Engine 的权限。如果您已经具有账号,则您已准备就绪。

您可能还需要一个用来测试的单独 Google 账号。

注册并试用 Compute Engine

首先,您可以使用以下指南之一在 Compute Engine 上创建虚拟机实例:

请务必先熟悉 Compute Engine 基础知识,然后再继续操作。 API 文档假定您已使用 Compute Engine,并且您熟悉网页编程概念和网页数据格式。

了解身份验证

您可以通过多种不同的方式向 Compute Engine 进行身份验证,具体取决于您访问 API 的方式。如需了解详情,请参阅向 Compute Engine 进行身份验证

了解 REST

您可以通过以下两种方式调用 API:

  • 发送 HTTP 请求并解析响应。
  • 使用客户端库

如果您决定不使用客户端库,则将需要了解 REST 的基础知识。

REST 是一种软件架构样式,可提供便利、一致的方法来请求和修改数据。

术语 REST 是“具象状态传输”的简称。在 Google API 的上下文中,指的是使用 HTTP 谓词来检索和修改由 Google 存储的数据的表示法。

在 RESTful 系统中,资源存储在数据存储区中;在客户端发送要求服务器执行特定操作(例如创建、检索、更新或删除资源)的请求之后,服务器便会执行该操作并发送响应,此响应的格式通常为所指定资源的表示法。

在 Google 的 RESTful API 中,客户端使用 HTTP 谓词(例如 POSTGETPUTDELETE)指定操作。它通过以下格式的全局唯一 URI 来指定资源:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

由于所有 API 资源都具有 HTTP 可访问的唯一 URI,因此 REST 启用了数据缓存,而且经过优化以与网络的分布式基础架构一起使用。

您可能会发现 HTTP 1.1 标准文档中的方法定义十分有用;这些定义中包含了 GETPOSTPUTDELETE 的规范。

Compute Engine API 中的 REST

Compute Engine API 操作可直接映射到 REST HTTP 谓词。

Compute Engine API URI 的具体格式如下:

https://www.googleapis.com/compute/v1/resourcePath?parameters

Compute Engine API 参考文档总结了用于 API 中各项受支持操作的全套 URI。

了解 JSON 数据格式

Compute Engine API 以 JSON 格式返回数据。

JSON(JavaScript 对象表示法)是一种与语言无关的常见数据格式,可通过简单的文本来表示任意数据结构。如需了解详情,请参阅 json.org