排查 API 错误

本页介绍了如何排查 Google 表格 API 错误。

400 Bad Request

此错误表示请求格式不正确。如需排查这些请求的问题,请参阅参考文档支持页面

500 Internal Server Error

如果您在使用 Google 表格 API 时遇到 500 错误,通常表示 API 本身存在问题。在 Google 表格 API 问题跟踪器中提交 bug 报告,并附上导致错误的请求。

503 Service Unavailable

当服务不可用或请求或电子表格的复杂性较高时,Google 表格 API 会返回 503 错误。以下是一些建议,可通过修改 API 请求和底层电子表格来限制 503 错误的速率。

请求

  • 使用 batchUpdate 将相关更新合并到单个请求中。批量处理大型更新时请务必小心,因为这可能会触发超时。
  • 将每个电子表格向 API 发出的并发请求数限制为每秒 1 个请求。
  • 对于大型电子表格,请使用 A1 表示法仅检索必要的电子表格值,并限制使用 includeGridData
  • 使用字段掩码限制 API 返回的数据量。
  • 采用指数退避算法重试请求。

电子表格

  • 对于经常更新的工作表,请定期切换到新的电子表格,以减少版本累积。
  • 限制使用 IMPORTRANGEQUERY 和其他复杂公式。
  • 考虑将大型电子表格拆分为多个电子表格。
  • 限制将单个电子表格用作许多 IMPORTRANGE 公式的来源。
  • 仅允许需要该电子表格的用户访问它。