用量限制

Google Forms API 是共用服務,因此我們設有配額和限制,確保所有使用者都能公平使用,並維護 Google Workspace 系統的整體健康狀態。

如果超出配額,通常會收到 429: Too many requests HTTP 狀態碼回應。如果發生這種情況,請使用指數輪詢演算法,稍後再試。只要不超過下列每分鐘配額,每天可提出的要求數量就沒有限制。

注意:表單監控功能有其他限制。詳情請參閱「設定及接收推播通知」。

下表詳細列出要求限制:

配額
讀取要求數
每項專案每天 無限制
每項專案每分鐘 975
每項專案每位使用者每分鐘 390
耗用大量資源的讀取要求

(用於 forms.responses.list 要求)。

每項專案每天 無限制
每項專案每分鐘 450
每項專案每位使用者每分鐘 180
寫入要求數
每項專案每天 無限制
每項專案每分鐘 375
每項專案每位使用者每分鐘 150

解決時間配額錯誤

對於所有時間型錯誤 (每 X 分鐘最多 N 個要求),建議您的程式碼擷取例外狀況,並使用截斷指數輪詢,確保裝置不會產生過多負載。

指數輪詢是網路應用程式的標準錯誤處理策略,指數輪詢演算法會重試要求,並以指數方式增加要求之間的等待時間,直到達到最大輪詢時間。如果要求仍未成功,請務必逐漸增加要求之間的延遲時間,直到要求成功為止。

演算法範例

指數輪詢演算法會以指數方式重試要求,並增加重試之間的等待時間,直到達到最大輪詢時間。例如:

  1. 向 Google 表單 API 提出要求。
  2. 如果要求失敗,請等待 1 + random_number_milliseconds,然後重試要求。
  3. 如果要求失敗,請等待 2 + random_number_milliseconds 秒,然後重試要求。
  4. 如果要求失敗,請等待 4 + random_number_milliseconds 秒,然後重試要求。
  5. 依此類推,時間上限為 maximum_backoff。
  6. 繼續等待及重試,直到重試次數達特定上限,但不要增加重試之間的等待時間。

其中:

  • 等待時間為 min(((2^n)+random_number_milliseconds), maximum_backoff),其中 n 會在每次疊代 (要求) 時遞增 1。
  • random_number_milliseconds 是小於或等於 1,000 的隨機毫秒數。這有助於避免許多用戶端因某些情況而同步,並同時重試,以同步波傳送要求。每次重試要求後,系統都會重新計算 random_number_milliseconds 的值。
  • maximum_backoff 通常是 32 或 64 秒,適當的值取決於用途。

用戶端在達到 maximum_backoff 時間後,可以繼續重試。此時重試就不需要繼續增加輪詢時間。舉例來說,如果用戶端使用的 maximum_backoff 時間為 64 秒,則達到這個值後,用戶端可以每 64 秒重試一次。在某些情況下,應避免用戶端無限次重試。

重試之間的等待時間和重試次數取決於您的用途和網路狀況。

定價

Google Forms API 的所有標準用途皆不需額外付費。預計在 2026 年稍晚,如果超出配額要求限制,Google Cloud 帳單帳戶將產生費用。詳情請參閱「Google Workspace 標準化模型:代理工具和 API」。

申請提高配額

視專案的資源用量而定,您可能需要要求調整配額。服務帳戶發出的 API 呼叫會視為使用單一帳戶。我們不保證一定能核准您提出的配額調整要求。如果配額調整要求會大幅提高配額值,可能需要較長時間才能獲得核准。

並非所有專案的配額都相同。隨著 Google Cloud 用量增加,您可能需要提高配額。如果您預期使用量將大幅攀升,可以透過 Google Cloud 控制台的「配額與系統限制」頁面,主動提出配額調整要求。

如要進一步瞭解相關內容,請參閱下列資源: