限制和配額可避免自動化程序不當使用 Reseller API，進而保護 Google 基礎架構。要求過多可能是因為輸入錯誤或系統設計效率不彰。為確保 Google Workspace 系統的健康狀態，當流量達到特定程度時，Google 會封鎖來自特定來源的流量。確保開發人員的行為不會對社群造成負面影響。
API 要求失敗
如果 API 要求失敗，應用程式會收到 HTTP 狀態碼。403 狀態碼表示輸入內容有誤，503 狀態碼則表示已超出 API 配額。您可以根據這些回應偵測錯誤並採取行動。
時間相關錯誤
如果是以時間為準的錯誤，尤其是 503 狀態碼，請使用指數輪詢演算法。請稍待片刻，再重試失敗的通話。舉例來說，請等待 5 秒後再重試。如果成功，請針對其他執行緒重複執行此模式。如果第二次要求失敗，請調降要求頻率，直到呼叫成功為止。建議您決定重試次數上限，例如 5 到 7 次。
限制
| API 限制類別 | 限制 |
|---|---|
訂閱方案 purchaseOrderId |
這個屬性最多可接受 80 個純文字字元。 |
訂閱方案 maxResults |
maxResults 查詢字串可包含 1 到 100 個結果。
預設值為 20 個結果。
|
轉移權杖 (customerAuthToken) |
客戶的轉移權杖會在產生後 30 天內有效。 |
| 客戶的使用者人數上限 | 視合約而定，使用者人數上限為 50,000 人，或經銷商合約中定義的上限。 |
| 未授權要求 | Google 不允許未經授權的要求存取 Reseller API。如果未提供授權權杖，要求即為未經授權。詳情請參閱「瞭解驗證和授權」。 |
其他限制類型
| 其他限制類型 | 限制和規範 |
|---|---|
| 資料格式 |
資料格式為 JavaScript 物件標記法 (JSON)。
JSON 是網路上常見的格式，用於表示任意資料結構。這是一種與語言無關的文字格式，使用的慣例與 C 系列語言 (包括 C、C++、C#、Java、JavaScript、Perl 和 Python) 的程式設計師所熟悉的慣例相同。 |
| 時間格式 | 日期和時間採用以毫秒為單位的 Epoch 轉換器。這個格式適用於訂閱建立時間、方案約期開始和結束時間，以及免費試用期結束時間。 |