用量限制

由於 Google Meet REST API 是共用服務，我們設有配額和限制，確保所有使用者都能公平使用，並維護 Google Workspace 系統的整體效能。

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

下表詳細列出查詢限制：

配額
讀取要求數
每項專案每分鐘 6000
每位使用者每項專案每分鐘 600
寫入要求數
每項專案每分鐘 1000
每位使用者每項專案每分鐘 100
減少寫入要求

(用於 spaces.create 個要求)。

每項專案每分鐘 100
每位使用者每項專案每分鐘 10

解決時間配額錯誤

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

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

演算法範例

指數輪詢演算法會以指數方式重試要求，並將每次重試之間的等待時間逐漸增加至最大輪詢時間，例如：

  1. 對 Google Meet 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 Meet API。超出配額要求限制不會產生額外費用，也不會向您的帳戶收費。

申請提高配額

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

並非所有專案的配額都相同。隨著您使用 Google Cloud 的時間越長，配額值可能需要增加。如果預期用量將大幅攀升，可以透過 Google Cloud 控制台的「配額」頁面主動要求調整配額。

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