API 使用限制

限制和配額可避免 Google 基礎架構採用自動化程序,以不當方式使用 Groups Settings API。來自 API 的過多要求可能會導致錯字或系統設計不良,因而產生不必要的 API 呼叫。無論原因為何,在 Google Workspace 系統的整體健康狀態必須達到一定程度時,封鎖來自特定來源的流量。

API 要求失敗

萬一 API 要求失敗,應用程式會收到 HTTP 狀態碼回應。403 的 HTTP 狀態碼會包含錯誤資訊,指出已超過哪些 API 配額。回應可讓您的自訂應用程式偵測錯誤並採取適當行動。

具時效性的要求

如果要求必須在固定的時間內完成,請同時傳送要求,或是在 Java 或 C# 應用程式中使用多個執行緒。例如,按照月份或其他時間範圍細分要求。如果是執行緒,請嘗試從 10 個執行緒開始,每項要求一個執行緒。執行緒建議有權衡取捨,不適合所有 API 情況。如果要求數量過大,就會發生配額錯誤。

以時間為準的錯誤

如果是基於時間限制的所有錯誤 (每個執行緒最多 N 個項目,尤其是 503 狀態碼錯誤),建議您讓程式碼擷取例外狀況,並使用指數輪詢演算法,等到短暫延遲再重試失敗的呼叫。其中一個執行緒的 Groups Settings API 範例是等待 5 秒,然後重試失敗的呼叫。如果要求成功,請為其他執行緒重複此模式。如果第二個要求失敗,應用程式應縮減要求的頻率,直到呼叫成功為止。舉例來說,請將初始延遲時間提高為 10 秒,然後重新重試失敗的呼叫。此外,也請設定重試限制。例如,以不同的延遲時間重試要求 5 至 7 次,應用程式會將錯誤傳回給使用者。

配額

API 配額類別 配額
每日查詢次數

每日最多可進行 100,000 次查詢。如果您需要超過這個限制的容量,可以透過 Google Cloud 控制台的配額頁面傳送要求

群組說明 (大小上限) 您最多可以輸入 300 個半形字元的群組說明。
群組名稱、大小上限 群組名稱的長度上限為 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」。