設定限制和配額後,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 不接受任何未經授權的要求。如未提供授權權杖,系統會將要求視為未授權。詳情請參閱授權要求 。 |