通过客户端库,您可以更轻松地使用支持的语言访问 Google Cloud API。虽然您可以通过向服务器发出原始请求来直接使用 Google Cloud API,但客户端库可实现简化,从而显著减少您需要编写的代码量。
本文档介绍了 Google 为 Cloud API 提供的不同类型的客户端库。您还可以在产品或语言文档中找到更多关于产品或选定语言的可用库的信息。
Cloud 客户端库
Cloud 客户端库 是以编程方式访问 Cloud API 的推荐选项,其中 可用。Cloud 客户端库使用最新的客户端库模型,并且:
- 提供每种语言的惯用代码,以简化 Cloud API 直观使用。
- 在客户端库之间提供一致的样式,以简化使用 和多项云服务
- 处理与服务器通信的所有低层级细节,包括通过 Google 进行身份验证。
- 可以使用熟悉的软件包管理工具(例如
npm
和pip
。 - 在某些情况下,使用 gRPC 将为您带来性能优势。如需了解详情,请参阅 gRPC API。
您可以在所用 Cloud API 的“客户端库”页面上找到 Cloud 客户端库的安装说明和参考资料。您可以找到一些链接 Cloud 客户端库及其参考文档 “Cloud 客户端库”页面。
Google API 客户端库
一些 Google Cloud API 没有完全提供 Cloud 客户端库 语言。如果您想使用其中一个 API,并且 Cloud 客户端库,您仍然可以使用 客户端库样式,称为 Google API 客户端库。 如果你要升级已经升级的项目,也可以使用这些库。 使用它们。此类库具有以下特点:
- 仅提供对 API 的 REST 接口的访问权限;不支持 gRPC。
- 具有自动生成的接口代码(可能不像 Cloud 客户端库那样惯用)。
- 处理与服务器通信的所有低层级细节,包括 进行 Google 身份验证。
- 可以使用熟悉的软件包管理工具(如
npm
和pip
)进行安装。
您可以在相关 Cloud API 的“客户端库”页面上找到这些库的链接。
使用 Firebase 移动平台
Firebase 是 Google 上用于在移动设备上构建应用的解决方案。它提供了一个包含客户端代码的 SDK,让您可以从 iOS、Android 和 Web 应用访问与移动设备相关的 Cloud API。有关支持的 Cloud API 以及如何开始使用 Firebase,请参阅 Firebase 文档。
使用您自己的客户端代码
如果您是一位经验丰富的开发者,并且 Google 的客户端库不符合您的 您可以编写自己的自定义代码来访问服务的 较低级别的服务 API
REST/HTTP API
所有 Cloud API 都公开了一个简单的传统 JSON/REST 接口。如果您需要编写自己的自定义代码以使用第三方 HTTP 客户端库来直接访问 REST API,您可以在 HTTP 准则中找到关于 Cloud API 如何使用不同的 HTTP 版本和实现的更多信息。
gRPC API
gRPC 是一个语言无关、平台无关的开源远程过程调用 (RPC) 系统,最初由 Google 开发。如需了解相关信息,请访问: grpc.io. 支持 gRPC 的 Cloud API 通常同时具有 REST 和 RPC 接口, 与支持 gRPC 的 API 的 REST 接口通信,而不仅仅是通过 HTTP 使用 JSON 客户也可以使用 协议缓冲区 以及通过 HTTP2 和 gRPC 与 RPC 接口通信您可以了解某个 API 是否 查看已启用 gRPC 的“API 和参考”部分。
如果 Cloud API 启用了 gRPC,您可以生成自己的 gRPC 客户端库 使用任何 gRPC 支持的语言为其创建映像。为此,您需要 协议缓冲区 服务定义(通常可从 GitHub 上的代码库)。 然后,您可以按照首选语言的相关说明进行操作 grpc.io 生成并使用您的客户端
如果您不想生成自己的 gRPC 代码,您仍然可以从 gRPC 中受益:越来越多的启用了 gRPC 的 API 的 Cloud 客户端库“在后台”使用 gRPC 与 Google 的服务器进行通信。这与 在吞吐量和 CPU 使用方面效率更高 - 访问 API 使用 gRPC 可以将每个 CPU 的吞吐量提高至原来的 10 倍 JSON REST APIGoogle 计划将尽可能多的 Cloud 客户端库升级到 gRPC;与此同时,您仍将获得 Google 客户端库代码的所有其他好处。
访问 Cloud API 的其他方式
如果您不想以编程方式访问 API,则可以使用 Google Cloud CLI 中的工具或使用 Google Cloud 控制台 来访问一些相同的功能。