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