排查 API 错误

本页介绍了如何排查使用 Sheets API 时发生的错误。

400 Bad Request

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

500 Internal Server Error

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

503 Service Unavailable

当服务不可用或 当请求或电子表格比较复杂时。以下是 建议通过修改 API 请求来限制 503 错误发生率， 和底层电子表格

请求

  • 使用 batchUpdate 将相关更新合并到单个请求中。 批处理大型更新时需小心谨慎， 超时。
  • 将每个电子表格的 API 并发请求数限制为 1 每秒请求数
  • 对于大型电子表格，使用 A1 表示法，并限制 includeGridData 的使用。
  • 使用字段掩码来限制 API 返回的数据量。
  • 在重试请求时使用指数退避算法。

电子表格

  • 对于经常更新的工作表，请定期轮替至新的电子表格， 减少版本数量
  • 限制使用 IMPORTRANGE、QUERY 和其他复杂公式。
  • 考虑将大型电子表格拆分为多个电子表格。
  • 限制将单个电子表格用作多个 IMPORTRANGE 的来源 公式。
  • 仅允许需要电子表格的人员访问该电子表格。