提升性能

本文档将介绍可用于提高应用性能的技巧。您所使用的特定 API 的文档应具有类似的页面,其中提供了有关其中某些主题的更多详细信息。 例如,请参阅 Google Drive API 的性能提示页面

关于 gzip

此客户端库会请求对所有 API 响应进行 gzip 压缩,并为您解压缩数据。 虽然这种方法需要一些额外的 CPU 时间来对结果进行解压缩,但考虑到它对节约网络费用的贡献,通常还是值得一用的。

部分响应(字段参数)

默认情况下,服务器在处理请求后会发回资源的完整表示形式。为了提高性能,您可以要求服务器仅发送您真正需要的字段,从而只接收部分响应

如需请求部分响应,请向任意 API 方法添加标准 Fields 参数。此参数的值用于指定您希望返回的字段。 您可以在任何返回响应数据的请求中使用此参数。

在以下代码段中,调用了发现服务的 GetRest 方法。Fields 参数的值设置为 description,title。因此,返回的对象将只包含说明和标题字段。

var service = new DiscoveryService();
var request = service.Apis.GetRest("calendar", "v3");
request.Fields = "description,title";
var result = request.Execute();
  

请注意,我们如何使用英文逗号来分隔所需字段,以及如何使用斜杠来表示父字段中包含的字段。Fields 参数还有其他格式设置选项;如需了解详情,请参阅所用 API 的文档中的“性能提示”页面。

部分更新(补丁)

如果您要调用的 API 支持补丁,则可以避免在修改资源时发送不必要的数据。 对于这些 API,您可以调用 Patch 方法,并提供要为资源修改的参数。

如需详细了解补丁语义,请参阅所用 API 的文档中的“性能提示”页面。

Batch

如果您要发送许多小请求,则可能受益于批处理,这种处理可将这些请求捆绑到一个 HTTP 请求中。