限制和配額可避免 Google 基礎架構在自動化流程中,以不當方式使用 Groups Settings API。API 提出過多要求,可能是因為無害的錯字,或系統設計不佳,導致不必要的 API 呼叫。無論原因為何,只要來自特定來源的流量達到一定程度,Google Workspace 系統就會封鎖該來源,以維護整體健康狀態。
API 要求失敗
如果 API 要求失敗 (這種情況很少發生),應用程式會收到 HTTP 狀態碼回應。HTTP 狀態碼 403 包含錯誤資訊,指出超出哪些 API 配額。自訂應用程式可根據回應偵測錯誤,並採取適當行動。
具時效性的要求
如果要求必須在固定時間內完成,請平行傳送要求,或在 Java 或 C# 應用程式中使用多個執行緒。例如,按月或其他時間範圍拆分要求。如果是執行緒,請先嘗試 10 個執行緒,每個要求一個執行緒。執行緒建議有利有弊,不適用於所有 API 情況。如果要求數量過多,就會發生配額錯誤。
時間相關錯誤
對於所有與時間相關的錯誤 (每個執行緒每 X 秒最多 N 個項目),尤其是 503 狀態碼錯誤,建議您的程式碼擷取例外狀況,並使用指數輪詢演算法,等待一小段時間後再重試失敗的呼叫。以 Groups Settings API 為例,單一執行緒的處理方式是等待 5 秒,然後重試失敗的呼叫。如果要求成功,請對其他執行緒重複這個模式。如果第二次要求失敗,應用程式應降低要求頻率,直到呼叫成功為止。舉例來說,將初始的 5 秒延遲時間增加到 10 秒,然後再次重試失敗的呼叫。此外,請決定重試次數上限。舉例來說,在應用程式向使用者傳回錯誤之前,請以不同的延遲時間重試要求 5 到 7 次。
配額
| API 配額類別 | 配額 |
|---|---|
| 每日查詢次數 | 每天最多可執行 100,000 項查詢。如果需要超過這項限制的容量,可以透過 Google Cloud 控制台的「Quotas」(配額) 頁面提出要求。 |
| 群組說明,大小上限 | 群組說明最多可輸入 4,096 個字元。 |
| 群組名稱,大小上限 | 群組名稱最多可包含 60 個字元。 |
defaultMessageDenyNotificationText |
通知文字最多可達 10,000 個字元。如要進一步瞭解 defaultMessageDenyNotificationText 屬性,請參閱 API 參考資料。 |
maxMessageBytes |
預設的郵件大小上限為 1 MB。如要進一步瞭解 maxMessageBytes 屬性,請參閱 API 參考資料。 |
限制
| 限制類型 | 限制和規範 |
|---|---|
| 資料格式,預設 |
預設資料格式為 JSON。API 也支援 Atom 格式。JSON 和 Atom 資料格式都支援完整的讀寫功能。詳情請參閱 JSON 和 Atom 資料格式。 |
| Groups Settings API,啟用 | 您必須先啟用 Directory API,才能呼叫 Groups Settings API。詳情請參閱「啟用 Google Workspace API」。 |