本页介绍了如何排查 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 返回的数据量。
- 采用指数退避算法重试请求。
电子表格
- 对于经常更新的工作表,请定期轮换到新的电子表格,以减少版本累积。
- 限制使用
IMPORTRANGE
、QUERY
和其他复杂公式。 - 考虑将大型电子表格拆分为多个电子表格。
- 限制使用单个电子表格作为多个
IMPORTRANGE
公式的数据源。 - 仅允许需要访问该电子表格的用户访问。