用量限制和配額

設定限制和配額後,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 控制台的「配額」頁面主動提出配額調整要求

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