限制和配額可以保護 Google 基礎架構,使其無法自動化處理程序以不當方式使用 Developer API。API 發出太多要求時,有可能是無害的錯字,或是因為效率不佳的系統造成不需要的 API 呼叫。無論原因為何,為了保障 Google Workspace 系統的整體健康狀態,在來源達到特定等級時,必須封鎖來自該來源的流量。這樣才能確保開發人員的動作不會對更廣大的社群造成負面影響。
API 要求失敗
萬一 API 要求失敗,應用程式會收到 HTTP 狀態碼回應。403
狀態碼包含錯誤輸入相關錯誤資訊,而 503
的 HTTP 狀態碼含有錯誤資訊,指出已超過哪個 API 配額。這些回應可讓自訂應用程式偵測這些錯誤並採取適當行動。
時間方面的錯誤
針對所有根據時間發生的錯誤 (每個執行緒 N 秒最多 N 秒),特別是 503
狀態碼錯誤,建議您讓程式碼擷取例外狀況,並使用指數輪詢演算法,等待一小段延遲時間再重試失敗的呼叫。其中一個執行緒的 Reseller API 範例為等待 5 秒,然後重試失敗的呼叫。如果要求成功,請針對其他執行緒重複這個模式。如果第二個要求失敗,應用程式應根據要求的頻率縮減資源,直到呼叫成功為止。例如,將初始 5 秒延遲時間提高至 10 秒,然後再次重試失敗的呼叫。此外,請決定重試限制。例如,在不同的延遲時間之間重試要求 5 到 7 次,直到應用程式將錯誤傳回給使用者。
限制
API 限制類別 | 限制 |
---|---|
訂閱 purchaseOrderId |
此屬性接受最多 80 個純文字字元。 |
訂閱 maxResults |
maxResults 查詢字串可以是 1 到 100 筆結果。預設值為 20 筆結果。 |
轉移權杖 (customerAuthToken ) |
客戶的轉移權杖在產生後的 30 天內有效。 |
單一客戶的使用者人數上限 | 視您的合約而定,使用者人數上限可以是 50,000 人,或是經銷商合約中定義的人數上限。 |
未獲授權的要求 | Google 不允許未經授權的向經銷商 API 提出要求。 如未提供授權權杖,系統會將要求視為未授權。詳情請參閱「瞭解驗證和授權」一文。 |
其他限制類型
其他限制類型 | 限制和規範 |
---|---|
資料格式 |
資料格式採用 JavaScript 物件標記法 JSON。 JSON 是常見的網際網路格式,可呈現任意資料結構的方法。JSON 是完全與語言無關的文字格式,但使用 C、C++、C#、Java、JavaScript、Perl 和 Python 等 C 系列程式設計師都熟悉的慣例。 |
時間格式 | 所有日期時間都以毫秒為單位的 Epoch 紀元轉換器。這種格式適用於訂閱建立時間的值、方案的承諾使用合約開始與結束時間,以及 30 天免費試用期的結束時間。 |