排查 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 返回的数据量。
  • 重试请求时使用指数退避算法。

电子表格

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