客户端库最佳做法

以下最佳做法可帮助您在同时使用 Cloud 客户端库Google API 客户端库时获得最佳性能和最佳体验。

重复使用客户端对象和会话

使用相同的库发出请求时,应尽可能将同一个客户端对象用于多个请求,而不是为每个请求创建一个新的对象。来自同一实例的请求将共享身份验证凭据实例。

会话客户端实例发出的初始请求会执行身份验证、授权和访问令牌生成操作。此处理过程只需数秒即可完成,因为它是通过网络处理的。要对同一个用户端实例进行额外调用,只要访问令牌还有效(通常有效期为一小时),会话客户端就会重复使用同一个访问令牌。过期后,会话客户端会自动刷新访问令牌。为了实现最佳性能,建议您对应用发出的所有请求重复使用相同的会话客户端实例,并允许客户端根据需要刷新需要在同一组凭据下运行的所有请求的访问令牌。

此外,客户端库使用的某些身份验证策略关联了速率限制。由于每个客户端实例都有自己的凭据缓存,因此在短时间内创建太多缓存可能会限制速率,从而造成库请求无法通过身份验证。

固定生产依赖项

从软件包管理器(例如 npmpip)安装库时,请务必使用其内置版本控制来固定版本以用于生产。这样可确保构建始终使用这些库的相同版本。如果您选择使用可更改其 API 表面的 beta 版客户端,这一点尤为重要。相关库的文档在库软件包文档中对此进行了记录。

及时掌握最新动态

随着 Google Cloud 的功能和 API 不断变化,客户端库也随之变化。客户端库经常更改,其中许多客户端库每天都在更新和发布。为了获得最佳的支持体验,您应该及时掌握最新版本。许多库都支持语义版本控制,以便轻松确定执行升级所需的工作量。如果您遇到性能下降(或问题)并且使用的是旧版客户端库,请考虑对其进行升级以利用新版中的所有改进功能。