Compute Engine 客户端库

Google Compute Engine API 是基于 HTTP 和 JSON 构建的，因此任何标准 HTTP 客户端均可向其发送请求并解析响应。

不过，除了手动创建 HTTP 请求并解析响应外，您可能还想使用 Google API 客户端库。客户端库能提供更好的语言集成、更高的安全性并支持进行需要用户授权的调用。

您可通过大量 Google 提供的库或已知用于 Compute Engine 的第三方开源库来使用 Compute Engine API。本文档既介绍了 Google 提供的库，也介绍了一些可用的第三方开源库。

可用的库

社区库

库	语言	供应商	网站	Compute Engine 使用入门
libcloud	Python	社区	网站	文档
jclouds	Java、Clojure	社区	网站	文档
fog.io	Ruby	社区	网站	文档

Google Cloud 客户端库

库	语言	供应商	网站	Compute Engine 使用入门
Google Cloud Node.js 客户端库	Node.js	Google	网站	文档

Google API 客户端库

库	语言	供应商	网站	Compute Engine 使用入门
Google API Java 客户端库	Java	Google	网站	文档
Google API .NET 客户端库	.NET	Google	网站	文档
Google API Go 客户端库	Go	Google	网站	文档
Google API JavaScript 客户端库	JavaScript	Google	网站	文档
Google API Ruby 客户端库	Ruby	Google	网站	文档
Google API Node.js 客户端库	Node.js	Google	网站	文档
Google API Objective C 客户端库	Objective C	Google	网站	文档
Google API PHP 客户端库	PHP	Google	网站	文档
Google API Python 客户端库	Python	Google	网站	文档

libcloud

libcloud 是一个 Python 库，可通过单个统一的 API 与许多主流云服务提供商进行交互。

Compute Engine 注释

自 2013 年 7 月以来，Apache libcloud API 项目持续获得了针对 Compute Engine 的可靠支持和更新。它支持多种 Compute Engine 功能，包括实例、磁盘、网络/防火墙和负载平衡器等。便利的入门演示提供了有关如何使用 libcloud 和 Compute Engine 的良好代码示例。

jclouds

jclouds 是一个开源库，可让您跨多个云提供商使用 Java 和 Clojure。

Compute Engine 注释

jclouds cloud API 支持 Compute Engine，并且可让用户管理虚拟机、磁盘和网络等资源。从 1.9 版开始，Compute Engine 已提升至 jclouds 核心。

fog.io

fog.io 是一个开源 Ruby 库，可让您通过一个 API 与多项云服务进行交互。

Compute Engine 注释

自 2013 年 5 月的 1.11.0 版起，fog.io cloud API 就提供了对 Compute Engine 的支持。请查看 fog.io 文档，开始使用 Compute Engine 和 fog。它支持创建、销毁和引导等实例操作，还支持管理其他资源（如磁盘、网络和负载均衡器）。

Google Cloud Node.js 客户端库

阅读 Compute Engine Node.js 入门指南。

Google API Java 客户端库

本页面包含了有关如何通过适用于 Java 的 Google API 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

浏览适用于 Compute Engine API 的 JavaDoc 参考。
阅读适用于 Java 的 Google API 客户端库的开发人员指南。
使用适用于 Compute Engine API 的 API Explorer 在您的浏览器中与此 API 进行交互。

示例

compute-engine-cmdline-sample 可以帮助您开始使用客户端库。

将库添加到项目中

从以下标签中选择您的构建环境（Maven 或 Gradle），或下载包含您所需所有 jar 的 zip 文件：

下载

下载适用于 Java 的 Compute Engine API v1 客户端库。

请参阅 compute/readme.html 文件，了解关于以下方面的详细信息：

zip 文件包含什么内容。
每种应用类型（网页应用、需要安装的应用或 Android 应用）需要哪些相关 jar。

libs 文件夹包含您在各种应用类型中可能需要的所有全局适用的依赖项。

Maven

将以下内容添加到您的 pom.xml 文件中：

请查看 Maven Central Repository 上的所有可用版本。

Gradle

将以下内容添加到您的 build.gradle 文件中：

请查看 Maven Central Repository 上的所有可用版本。

Google API .NET 客户端库

本页面包含了有关如何通过适用于 .NET 的 Google API 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

浏览适用于 Compute Engine API 的 .NET 参考文档。
阅读适用于 .NET 的 Google API 客户端库的开发者指南。
使用适用于 Compute Engine API 的 API Explorer 在您的浏览器中与此 API 进行交互。

下载库

安装 Google.Apis.compute 中提供的 NuGet 软件包。

Google API Go 客户端库

本部分包含了有关如何通过 Google API Go 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

阅读 Google API Go 客户端库的入门指南。
使用 Google API Explorer 在浏览器中与 API 进行交互。

下载并安装库

要安装库，请运行以下命令：

go get google.golang.org/api/compute/v1

使用库

在您的代码中导入库：

package main

  import (
      "google.golang.org/api/compute/v1"
  )

Google API JavaScript 客户端库

本部分包含了有关如何通过 Google API JavaScript 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

阅读入门指南。
了解如何使用 JavaScript 客户端库进行开发。
查看专门针对 Compute Engine 的 JavaScript 使用入门示例。
使用 Google API Explorer 在浏览器中与 API 进行交互。

使用 API

要使用 API，您必须首先加载库。在您的代码中添加以下内容：

<script src="https://apis.google.com/js/client.js?onload=handleClientLoad"></script>

Google API Ruby 客户端库

本页面包含了有关如何通过适用于 Ruby 的 Google API 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

阅读适用于 Ruby 的 Google API 客户端库入门指南。
使用适用于 Compute Engine API 的 API Explorer 在您的浏览器中与此 API 进行交互。

安装 google-api-client gem

如果您之前并未安装 Ruby 版 Google API 客户端库，请打开一个终端并使用 RubyGems 进行安装：

$ gem install google-api-client

如果您已安装了 gem，只是想更新至最新版本：

$ gem update -y google-api-client

您可能需要在这些命令前面加上 sudo，具体取决于您的系统。

Ruby 版 Google API 客户端库使用入门

请务必查看我们详尽的入门指南，以快速了解如何提出第一个请求。

Google API Node.js 客户端库

阅读 Compute Engine Node.js 入门指南。

Google API Objective C 客户端库

本部分包含了有关如何通过 Google API Objective C 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

阅读概览。
使用 Google API Explorer 在浏览器中与 API 进行交互。

链接到库

按照说明将 Google API Objective-C 客户端库添加到项目中。

Google API PHP 客户端库

本部分包含了有关如何通过 Google API PHP 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

阅读安装指南。
从 GitHub 获取库。
使用 Google API Explorer 在浏览器中与 API 进行交互。

下载库

您可以将库作为依赖项添加到 composer.json 中来安装它。

"require": {
  "google/apiclient": "1.0.*"
}

如果您愿意的话，可以从 GitHub 上获取该库，并通过 git clone 方法将其克隆到一个本地代码库中。

git clone https://github.com/google/google-api-php-client.git .

使用库

定义库文件位置的最佳方法是将其添加到 PHP.ini 配置文件的路径中。

include_path = ".:/usr/local/lib/php:/path/to/google-api-php-client/src"

或者，您可以在代码中动态设置相同的 ini 指令。

set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/google-api-php-client/src');

Google API Python 客户端库

本页面包含了有关如何通过适用于 Python 的 Google API 客户端库开始使用 Compute Engine API 的信息。此外，您可能对以下文档感兴趣：

浏览适用于 Compute Engine API 的 PyDoc 参考。
阅读适用于 Python 的 Google API 客户端库的开发者指南。
使用适用于 Compute Engine API 的 API Explorer 在您的浏览器中与此 API 进行交互。

系统要求

操作系统：
- Linux
- Mac OS X
- Windows
Python 2.7 或 3.4 或更高版本

安装客户端库

您既可以使用文件包管理器，也可以手动下载并安装 Python 客户端库：

托管安装

利用 pip 或 setuptools 来管理您的安装（您可能需要先运行 sudo）：

pip（首选）：

$ pip install --upgrade google-api-python-client

Setuptools：使用 setuptools 软件包中包含的 easy_install 工具：
```
$ easy_install --upgrade google-api-python-client
```

手动安装

下载最新的 Python 版客户端库，将代码解压缩，并运行 python setup.py install

App Engine

由于 App Engine Python 运行时环境中未安装 Python 客户端库，您必须像安装第三方库一样通过 vendoring 方法将这些库添加到您的应用中。