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