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