排解 API 錯誤

本頁面說明如何排解 Sheets API 的錯誤。

400 Bad Request

此錯誤表示請求的格式錯誤。針對這些問題進行疑難排解 請參閱參考說明文件和 支援頁面。

500 Internal Server Error

如果您在使用 Sheets API 時遇到 500 錯誤， 通常表示 API 本身有問題。回報錯誤 將 Sheets API Issue Tracker 回報 錯誤。

503 Service Unavailable

Sheets API 會在服務無法使用時傳回 503 錯誤，或 在要求或試算表複雜度偏高的情況下。以下是 並提供一些建議，藉由修改 API 要求來限制 503 錯誤頻率 和基礎試算表

要求

  • 使用 batchUpdate 將相關更新合併為單一要求。 批次處理大型更新時，請特別小心，因為這可能會導致 逾時。
  • 將每份試算表的 API 並行要求數量限制為 1 個 每秒可處理的要求數
  • 若是大型試算表，請只擷取必要的試算表值，請使用 A1 標記法，並限制 includeGridData 的使用。
  • 使用欄位遮罩可限制 API 傳回的資料量。
  • 重試要求時使用指數輪詢。

試算表

  • 對於經常更新的工作表，請定期旋轉到新的試算表，以便 減少版本數量
  • 請避免使用 IMPORTRANGE、QUERY 和其他複雜的公式。
  • 建議您將大型試算表分割為多份試算表。
  • 限制使用單一試算表做為許多IMPORTRANGE的來源 。
  • 請限制只讓有需要的使用者存取試算表。