排解 API 錯誤

本頁說明如何排解試算表 API 相關錯誤。

400 Bad Request

這個錯誤代表要求格式錯誤。如需排解這些要求的問題，請參閱參考說明文件和支援頁面。

500 Internal Server Error

如果您在使用 Sheet API 時遇到 500 錯誤，通常表示 API 本身有問題。透過試算表 API Issue Tracker 來回報錯誤，並提供造成錯誤的要求。

503 Service Unavailable

Sheet API 會在服務無法使用、要求或試算表複雜度過高時傳回 503 錯誤。以下是一些建議，協助您修改 API 要求和基礎試算表來限制 503 錯誤發生率。

要求

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

試算表

  • 若是經常更新的工作表，請定期輪替至新的試算表，以減少版本累積次數。
  • 限制使用 IMPORTRANGE、QUERY 和其他複雜公式。
  • 建議您將大型試算表分成多份試算表。
  • 限制單一試算表做為多個 IMPORTRANGE 公式的來源。
  • 限制只有需要的使用者能存取試算表。