本文档将介绍可用于提高应用性能的技巧。您所使用的特定 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 请求中。