上限と割り当ては、Reseller API を不適切に使用する自動プロセスから Google インフラストラクチャを保護します。過剰なリクエストは、入力ミスや非効率的なシステム設計が原因で発生する可能性があります。Google Workspace システムの健全性を維持するため、特定のソースからのトラフィックが一定のレベルに達すると、Google はそのトラフィックをブロックします。つまり、あるデベロッパーの操作によってコミュニティに悪影響が及ぶ事態を防ぎます。
API リクエストの失敗
API リクエストが失敗すると、アプリケーションは HTTP ステータス コードを受け取ります。403 ステータス コードは入力が正しくないことを示し、503 ステータス コードは API 割り当てが上限を超えたことを示します。これらのレスポンスを使用してエラーを検出し、アクションを実行します。
時間ベースのエラー
時間ベースのエラー（特に 503 ステータス コード）には、指数バックオフ アルゴリズムを使用します。失敗した呼び出しを再試行する前に、少し遅延します。たとえば、5 秒待ってから再試行します。成功した場合は、他のスレッドについても同じパターンを繰り返します。2 回目のリクエストが失敗した場合は、呼び出しが成功するまでリクエストの頻度を減らします。再試行回数（5 ～ 7 回など）を決定することもおすすめします。
上限
| API 上限カテゴリ | 上限 |
|---|---|
定期購入 purchaseOrderId |
このプロパティでは、最大 80 文字の書式なしテキストを使用できます。 |
定期購入 maxResults |
maxResults クエリ文字列は 1 ～ 100 件の結果にできます。デフォルトは 20 件です。 |
移行トークン（customerAuthToken） |
お客様の移行トークンは、生成後 30 日間有効です。 |
| お客様の最大ユーザー数 | 契約に応じて、ユーザー数の上限は 50,000 人または販売パートナー契約で定義されている上限になります。 |
| 承認されていないリクエスト | Google は、Reseller API への未承認のリクエストを許可していません。認証トークンが提供されていない場合、リクエストは未承認です。詳細については、認証と認可についてをご覧ください。 |
その他の種類の制限
| その他の種類の制限 | 制限事項とガイドライン |
|---|---|
| データ形式 |
データ形式は JavaScript Object Notation（JSON）です。 JSON は、任意のデータ構造を表す一般的なインターネット形式です。これは、C、C++、C#、Java、JavaScript、Perl、Python などの C 言語系のプログラマーに馴染みのある規則を使用する、言語に依存しないテキスト形式です。 |
| 時刻の表示形式 | 日付と時刻は、エポック コンバータをミリ秒単位で使用します。この形式は、サブスクリプションの作成時間、プランの契約期間の開始時間と終了時間、無料試用期間の終了時間に適用されます。 |