限制與配額

設定限制和配額後,Google 基礎架構就不會自動以不當的方式使用 Enterprise License Manager API。API 發出太多要求時,有可能是無害的錯字,或是因為缺乏效率的系統而做出不需要的 API 呼叫。無論原因為何,只要特定來源的流量達到特定等級,Google Workspace 系統的整體健康狀態就會必須封鎖來自特定來源的流量。確保某位開發人員的行為不會對更廣大的社群造成負面影響。

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

如果您的要求必須在固定時間內完成,請以批次方式傳送要求。視您的 API 目的和要求數量過高時,可能會發生配額錯誤。

如果您無法使用建議的 API 批次處理要求功能,請使用指數輪詢演算法。針對所有根據時間 (每個執行緒最多 X 秒) 的錯誤,尤其是 503 狀態碼錯誤,建議您讓程式碼擷取該例外狀況,然後透過指數輪詢演算法,等待一小段延遲時間,然後再重試失敗的呼叫。一個執行緒的 Enterprise License Manager API 範例為等待 5 秒,然後重試失敗的呼叫。如果要求成功,請針對其他執行緒重複此模式。如果第二個要求失敗,您的應用程式應該縮減要求的頻率,直到呼叫成功為止。例如,將初始的 5 秒延遲時間提高至 10 秒,然後再次重試失敗的呼叫。此外,請決定重試限制。例如,在不同的延遲時間之間重試要求 5 到 7 次,直到應用程式將錯誤傳回給使用者。

API 配額類別 配額
每秒查詢次數 (QPS) QPS 配額為 1。
API 限制類別 限制
maxResults 查詢字串 maxResults 的大小上限為 100。
其他限制類型 限制和規範
批次要求
這個 API 支援傳送批次要求
API 回應中的資料格式 回應的資料格式為 JavaScript 物件標記法 (JSON)。
啟用 Enterprise License Manager API 必須先啟用 Provisioning API,才能呼叫 Enterprise License Manager API。在您的控制台中,前往 [使用者與群組] 標籤的「設定」頁面,然後啟用 Provisioning API。儲存變更。另外,您也必須啟用並啟用 Google 網路論壇服務。
未獲授權的要求 API 不接受任何未經授權的要求。如未提供授權權杖,系統會將要求視為未授權。詳情請參閱授權要求