排查 API 错误

本页介绍了如何排查 Sheets API 的错误。

400 Bad Request

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

500 Internal Server Error

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

503 Service Unavailable

当服务不可用或请求/电子表格的复杂程度较高时,Sheets API 会返回 503 错误。以下是一些建议,可帮助您通过修改 API 请求和底层电子表格来限制 503 错误的发生率。

请求

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

电子表格

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