客户端库说明

尽管您可以通过向服务器发出直接 HTTP 请求(或可用的 RPC 调用)来使用 Google Cloud API,我们还为所有 Cloud API 提供了客户端库代码,使您可以以偏好的语言更轻松地访问它们。本文档介绍了我们为 Cloud API 提供的不同类型的客户端库。您可以在产品或语言文档中找到更多关于产品或选定语言的可用库的信息。

Google Cloud 客户端库

Google Cloud 客户端库使用我们最新的客户端库模型,我们推荐通过它以编程方式访问 Cloud API(如适用)。Cloud 客户端库具有以下特点:

  • 提供每种语言惯用的生成或手写代码,使 Cloud API 的使用简单直观。
  • 处理与服务器通信的所有低层级细节,包括通过 Google 进行身份验证
  • 可以使用熟悉的软件包管理工具(如 npmpip)进行安装。
  • 在某些情况下,使用 gRPC 将为您带来性能优势。如需了解详情,请参阅下文的 gRPC API 部分。

您可以在所选 Cloud API 的“客户端库”页面上找到相应 Cloud 客户端库的安装说明和参考资料。您可以在 Cloud 客户端库页面中找到入门和参考文档的链接。

亲自尝试

如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。

免费开始使用

Google API 客户端库

许多 Google Cloud API 尚未提供所有语言的 Google Cloud 客户端库。如果您要使用其中一种 API 并且没有适用于您首选语言的 Cloud 客户端库,您仍然可以使用名为 Google API 客户端库的旧版客户端库。此类库具有以下特点:

  • 仅提供对 API 的 REST 接口的访问权限;不支持 gRPC。
  • 具有自动生成的接口代码(可能不像我们的新库那样惯用)。
  • 处理与服务器通信的所有低层级细节,包括通过 Google 进行身份验证
  • 可以使用熟悉的软件包管理工具(如 npmpip)进行安装。

如有需要,您可以在相关 Cloud API 的“客户端库”页面上找到这些库的链接。

使用 Firebase 移动平台

Firebase 是 Google 上用于在移动设备上构建应用的解决方案。它提供了一个包含客户端代码的 SDK,让您可以直接从 iOS、Android 和 网络应用访问与移动设备相关的 Cloud API。如需详细了解受支持的 Cloud API 以及如何开始使用 Firebase,请访问 Firebase 文档

使用您自己的客户端代码

通常,我们建议使用我们的客户端库来访问 Cloud API。但如果您是经验丰富的开发者并且我们的客户端库无法满足您的特定需求,您可以编写自己的自定义代码来直接访问服务的低层级服务 API。

REST/HTTP API

所有 Cloud API 都公开了一个简单的传统 JSON/REST 接口。如果您需要编写自己的自定义代码以使用您选择的第三方 HTTP 客户端库来直接访问 REST API,您可以在我们的 HTTP 准则中找到关于 Cloud API 如何使用不同的 HTTP 版本和实现的更多信息。

gRPC API

gRPC 最初由 Google 开发,是一款跨语言、跨平台、开源的远程过程调用 (RPC) 系统:您可以在 grpc.io 上了解更多相关信息。启用了 gRPC 的 Cloud API 通常同时具有 REST 和 RPC 接口,因此,除了使用基于 HTTP 的 JSON 与 REST 接口进行通信,启用了 gRPC 的 API 客户端还可以使用协议缓冲和基于 HTTP2 的 gRPC 与 RPC 接口进行通信。您可以通过查看“API 和参考”部分来了解 API 是否启用了 gRPC。

如果 Cloud API 启用了 gRPC,您可以使用 gRPC 支持的语言为其生成自己的gRPC客户端库。为此,您需要 API 的协议缓冲服务定义(通常可从 GitHub 上的代码库获得)。然后,您可以按照 grpc.io 上对您的首选语言的说明生成并使用您的客户端。

如果您不想生成自己的 gRPC 代码,您仍然可以从 gRPC 中受益:越来越多的启用了 gRPC 的 API 的 Cloud 客户端库“在后台”使用 gRPC 与 Google 的服务器进行通信。这在吞吐量和 CPU 使用率方面明显更为高效:与 JSON REST API 相比,使用 gRPC 访问 API 可以将每个 CPU 的吞吐量提高至多系数 10。我们计划将尽可能多的 Cloud 客户端库升级到 gRPC;与此同时,您仍将获得客户端库代码的所有其他好处。

访问 Cloud API 的其他方式

如果您不想以编程方式访问 API,则可以使用 Google Cloud SDK 中的工具或通过 Google Cloud Console 访问相同的功能。