用量限制和配額

設定限制和配額後，Google 基礎架構就不會自動以不當的方式使用 Alert Center API。API 發出太多要求時，有可能是無害的錯字，或是因為效率低落而無端 API 呼叫的系統所導致。無論原因為何，只要特定來源的流量達到特定等級，Google Workspace 系統的整體健康狀態就會必須封鎖來自特定來源的流量。確保某位開發人員的行為不會對更廣大的社群造成負面影響。

萬一 API 要求失敗，您就會收到 HTTP 狀態碼回應。403 狀態碼含有錯誤輸入相關錯誤資訊，且 HTTP 狀態碼為 503 時，則含有錯誤資訊，指出已超過哪個 API 配額。這些回應可讓自訂應用程式偵測這些錯誤，並採取適當行動。

如果您需要在固定時間內完成要求，請同時傳送要求，或是在 Java 或 C# 應用程式中使用多個執行緒。其中一個平行要求就是要求不同使用者傳送少量電子郵件，而不是同時新增或移除一位使用者的大量電子郵件。如果是討論串，請嘗試從 10 個討論串開始，每封使用者電子郵件一個討論串。請注意，執行緒建議需要權衡取捨，且對於部分 API 情境來說並不實用。如果要求數量過高，就會發生配額錯誤。

針對所有根據時間 (N每個執行緒最多 N 秒數) 的錯誤，尤其是 503 狀態碼錯誤，建議您讓程式碼擷取例外狀況，並採用指數輪詢指數輪詢演算法，等待系統重試小幅延遲時間，然後再重試。其中一個執行緒的 Alert Center API 範例是等待 5 秒後再重試失敗的呼叫。如果要求成功，請針對其他執行緒重複此模式。如果第二個要求失敗，您的應用程式應該縮減要求的頻率，直到呼叫成功為止。例如，將初始的 5 秒延遲時間提高至 10 秒，然後再次重試失敗的呼叫。此外，請決定重試限制。例如，在不同的延遲時間之間重試要求 5 到 7 次，直到應用程式將錯誤傳回給使用者。

API 限制類別 限制
快訊中心的 QPS 和 QPD 費率 API 會限制 API 控制台專案的要求數量。API 專案的每秒要求數量上限 (專案 QPS) 為 1000。此外，每位使用者每秒的要求數量上限 (使用者 QPS) 為 150。

如果超過這些限制，伺服器會傳回 HTTP 503 狀態碼。重試要求時，請使用指數輪詢演算法。

其他限制類型 限制和規範
資料格式 (預設) 預設的資料格式為 JSON。
未獲授權的要求 Google 不允許在未經授權的情況下對這個 API 提出要求。如未提供授權權杖，系統會將要求視為未授權。詳情請參閱授權要求。

要求提高每項專案的配額

視專案的資源用量而定，您可能會想要要求提高配額。服務帳戶的 API 呼叫視為單一帳戶。我們不保證一定能核准您提出的配額增加要求。大量提高配額可能需要較長時間才能通過核准。

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

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