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」。