由於 Google Chat API 是共用服務，我們會套用配額和限制，確保所有使用者都能公平使用這項服務，並保護 Google Workspace 的整體效能。
如果超出配額，您會收到 429: Too many requests HTTP 狀態碼回應。Chat 後端的其他頻率限制檢查也可能產生相同的錯誤回應。如果發生此錯誤，請使用指數輪詢演算法，稍後再試一次。只要不超過下表中列出的每分鐘配額，則沒有每天可提出的要求數量限制。
Chat API 方法適用兩種配額類型：每個聊天室配額和每個專案配額。
聊天室配額
每個聊天室配額會限制特定聊天室的查詢頻率，並由在該聊天室中執行的所有 Chat 應用程式共用，呼叫每個配額的 Chat API 方法。
下表詳細說明每個空間的查詢限制：
聊天室配額 |
Chat API 方法 |
限制 (每 60 秒，在聊天室中所有 Chat 應用程式之間共用 |
|---|---|---|
每分鐘讀取數 |
|
900 |
每分鐘寫入數 |
|
60 |
每項專案的配額
每個專案的配額會限制 Google Cloud 專案的查詢頻率，因此會套用至針對每個配額呼叫指定 Chat API 方法的單一 Chat 應用程式。
下表詳細說明每個專案的查詢限制。您也可以在「配額」頁面中查看這些限制。
每項專案的配額 |
Chat API 方法 |
限制 (每 60 秒) |
|---|---|---|
每分鐘的訊息寫入數 |
|
3000 |
每分鐘的訊息讀取數 |
|
3000 |
每分鐘會員寫入數 |
|
300 |
每分鐘會員讀取數 |
|
3000 |
每分鐘空間寫入作業數 |
|
60 |
每分鐘的聊天室讀取數 |
|
3000 |
每分鐘附件寫入數 |
|
600 |
每分鐘連結讀取數 |
|
3000 |
每分鐘的回應寫入數 |
|
600 |
每分鐘的回應讀取數 |
|
3000 |
額外用量限制
建立 GROUP_CHAT 或 SPACE 類型聊天室 (使用 spaces.create 或 spaces.setup 方法) 時，還有其他配額限制。每分鐘建立的此類型聊天室數量不得超過 35 個，每小時不得超過 800 個。DIRECT_MESSAGE 類型的空間不受這些額外配額限制的約束。
指定相同空間的 API 流量過高，可能會觸發額外的內部限制，而這些限制不會顯示在「配額」頁面中。
解決以時間為準的配額錯誤
針對所有時間相關錯誤 (每 X 分鐘最多 N 個要求)，建議您在程式碼中擷取例外狀況，並使用截斷的指數型延遲，確保裝置不會產生過多負載。
指數輪詢是網路應用程式的標準錯誤處理策略。指數輪詢演算法會以指數方式逐漸增加每次重試之間的等待時間，直到達到最大輪詢時間為止。如果要求仍無法成功，請務必讓要求之間的延遲時間隨著時間增加，直到要求成功為止。
演算法範例
指數輪詢演算法會以指數方式重試要求，並將每次重試之間的等待時間逐漸增加至最大輪詢時間，例如：
- 向 Google Chat API 提出要求。
- 如果要求失敗，請等待 1 +
random_number_milliseconds後再重試要求。 - 如果要求失敗，請等待 2 +
random_number_milliseconds秒後再重試要求。 - 如果要求失敗，請等待 4 +
random_number_milliseconds秒後再重試要求。 - 依此類推，時間上限為
maximum_backoff。 - 繼續等待及重試，直到重試次數達特定上限，但不再增加每次重試之間的等待時間。
其中：
- 等待時間為
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 秒重試一次的頻率。到了特定時間點後，用戶端應停止無限重試。
重試之間的等待時間和重試次數，取決於您的用途和網路狀況。
申請提高每個專案的配額
視專案的資源使用情形而定，您可能會想要求增加配額。服務帳戶的 API 呼叫會被視為使用單一帳戶。我們不保證一定能核准您申請更多配額。不過如要增加大量配額，可能會需要更長的核准程序處理時間。
並非所有專案的配額都相同。隨著 Google Cloud 的使用量隨時間增加，您可能需要提高配額。如果您預期用量將大幅攀升，可以透過 Google Cloud 控制台的「配額」頁面主動要求調整配額。
如要進一步瞭解相關內容，請參閱下列資源：