API 使用限制

限制和配額可保護 Google 基礎架構，避免自動化程序使用 Groups Settings API 以不當的方式使用。如果 API 發出過多要求， 無害的錯字或設計效率低落的系統，不需要無害的 API 呼叫。 無論原因為何，在流量達到特定層級時，都會封鎖來自特定來源的流量 維護 Google Workspace 系統整體健康狀態所需的資訊

API 要求失敗

萬一您的 API 要求失敗，應用程式會收到 HTTP 狀態碼 回應。403 的 HTTP 狀態碼含有錯誤資訊，指出哪個 API 配額 。回應可讓自訂應用程式偵測錯誤並採取適當處置 動作。

具時效性的要求

如果需要在固定的時間內完成要求，請同時傳送要求 或在 Java 或 C# 應用程式中使用多個執行緒。例如依照月份或 其他時間範圍。如果是執行緒，請嘗試從 10 個執行緒開始，每個要求一個執行緒。 執行緒建議具有權衡取捨，不適用於所有 API 情況。如果 要求過高，導致配額錯誤

以時間為準的錯誤

針對所有以時間為基礎的錯誤 (每個執行緒 X 秒內最多 N 個內容)，尤其是 503 狀態碼錯誤，建議程式碼擷取例外狀況，並使用 換 指數輪詢 演算法，等待一小段延遲時間，接著重試失敗的呼叫。Groups Settings API 範例 其中一個執行緒等待 5 秒，然後重試失敗的呼叫。如果要求成功，請重複這個步驟 其他執行緒的模式如果第二個要求失敗，應用程式 並縮減要求頻率，直到呼叫成功為止舉例來說，您可以將 這 5 秒的最初延遲時間為 10 秒，然後重新嘗試失敗的通話。此外，請考慮重試 我們會自動向帳單帳戶扣款 並每月或在您達到用量上限時發送帳單舉例來說，以不同延遲時間重試要求 5 至 7 次 向使用者傳回錯誤。

配額

API 配額類別	配額
每日查詢次數	每天最多可建立 100,000 筆查詢。如果所需容量超過 就可以透過 Google Cloud 控制台的「配額」頁面
群組說明 (大小上限)	群組說明的長度上限為 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」。