如果您尚未完成一些准备工作,请先完成,然后才能开始编写您的第一个客户端应用。
获取 Google 帐号
您需要 Google 帐号以获取在Google API Console 中访问 Google Compute Engine 的权限。如果您已经具有帐号,则您已准备就绪。
您可能还需要一个用来测试的单独 Google 帐号。
注册并试用 Google Compute Engine
按照入门指南中介绍的步骤注册该服务,设置 Linux 或 Windows 虚拟机实例,然后使用该实例来托管网页内容。
请务必先熟悉 Compute Engine 基础知识,然后再继续操作。API 文档假定您已使用 Compute Engine,并且您熟悉网页编程概念和网页数据格式。
了解授权
Google Compute Engine 使用 OAuth 2.0 对请求进行授权。如果您不熟悉 OAuth 2.0,请了解如何对请求授权。
了解 REST
您可以通过以下两种方式调用 API:
如果您决定不使用客户端库,则将需要了解 REST 的基础知识。
REST 是一种软件架构样式,可提供便利、一致的方法来请求和修改数据。
术语 REST 是“具象状态传输”的简称。在 Google API 的上下文中,指的是使用 HTTP 谓词来检索和修改由 Google 存储的数据的表示法。
在 RESTful 系统中,资源存储在数据存储区中;在客户端发送要求服务器执行特定操作(例如创建、检索、更新或删除资源)的请求之后,服务器便会执行该操作并发送响应,此响应的格式通常为所指定资源的表示法。
在 Google 的 RESTful API 中,客户端使用 HTTP 谓词(例如 POST
、GET
、PUT
或 DELETE
)指定操作。它通过以下格式的全局唯一 URI 来指定资源:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
由于所有 API 资源都具有 HTTP 可访问的唯一 URI,因此 REST 启用了数据缓存,而且经过优化以与网络的分布式基础架构一起使用。
HTTP 1.1 标准文档中的方法定义十分有用,其中包含 GET
、POST
、PUT
和 DELETE
规范。
Google Compute Engine API 中的 REST
Google Compute Engine API 操作可直接映射到 REST HTTP 谓词。
Google Compute Engine API URI 的具体格式如下:
https://www.googleapis.com/compute/v1/resourcePath?parameters
Google Compute Engine API 参考文档总结了用于 API 中各项受支持操作的全套 URI。
了解 JSON 数据格式
Google Compute Engine API 以 JSON 格式返回数据。
JSON(JavaScript 对象表示法)是一种与语言无关的常见数据格式,提供任意数据结构的简单文本表示法。如需了解详情,请参阅 json.org。