排解 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 公式。
  • 請只將試算表存取權授予需要的使用者。