限制和配額可保護 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 配額類別 | 配額 |
---|---|
每日查詢次數 | |
群組說明 (大小上限) | 群組說明的長度上限為 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」。 |