API 使用限制

限制和配額可避免 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」。