このページは Cloud Translation API によって翻訳されました。

制限と割り当て

制限と割り当ては、Enterprise License Manager API を不適切な方法で使用する自動プロセスから Google インフラストラクチャを保護します。API から過剰なリクエストが発生するのは、無害なタイプミスや、システムが非効率な設計で不要な API 呼び出しを行うことが原因かもしれません。原因にかかわらず、Google Workspace システムの全体的な健全性を保つには、特定のソースからのトラフィックを特定のレベルに達したらブロックする必要があります。あるデベロッパーの行為が、より大きなコミュニティに悪影響を与えることがないようにする。

万が一 API リクエストが失敗した場合は、HTTP ステータスコードレスポンスが返されます。ステータスコード 403 には入力ミスに関するエラー情報が含まれ、HTTP ステータスコード 503 には超過した API 割り当てを示すエラー情報が含まれます。これらのレスポンスにより、カスタムアプリケーションでこれらのエラーを検出して適切な措置を講じることができます。

リクエストを一定時間内に完了する必要がある場合は、リクエストをまとめて送信します。API の目的によっては、リクエストの数が多くなりすぎると、割り当てエラーが発生します。

推奨される API バッチリクエスト機能を使用できない場合は、指数バックオフアルゴリズムを使用します。時間ベースのすべてのエラー（スレッドあたり X 秒間で最大 N 個）、特に 503 ステータスコードエラーについては、コードで例外をキャッチし、指数バックオフアルゴリズムを使用してわずかな遅延を待ってから、失敗した呼び出しを再試行することをおすすめします。Enterprise License Manager API の 1 つのスレッドでは、5 秒待ってから失敗した呼び出しを再試行します。リクエストが成功したら、他のスレッドに対してこのパターンを繰り返します。2 番目のリクエストが成功しなかった場合、アプリケーションは呼び出しが成功するまでリクエストの頻度にスケールダウンします。たとえば、最初の 5 秒の遅延を 10 秒に増やして、失敗した通話を再試行します。また、再試行の上限も決定します。たとえば、遅延時間を変えてリクエストを 5 ～ 7 回再試行すると、アプリケーションからユーザーにエラーが返されます。

API 割り当てカテゴリ	割り当て
秒間クエリ数（QPS）	QPS 割り当ては 1 です。

API 制限のカテゴリ	上限
maxResults クエリ文字列	maxResults の最大サイズは 100 です。

その他の制限の種類	制限事項とガイドライン
バッチリクエスト	この API は、バッチリクエストの送信をサポートしています。
API レスポンスのデータ形式	レスポンスのデータ形式は JavaScript Object Notation（JSON）です。
Enterprise License Manager API の有効化	Enterprise License Manager API を呼び出す前に、Provisioning API を有効にする必要があります。コントロールパネルで [ユーザーとグループ] タブの [設定] ページに移動し、Provisioning API を有効にします。変更内容を保存後、また、Google グループサービスが有効になっている必要があります。
未承認のリクエスト	API は未承認のリクエストを受け付けません。認証トークンが指定されていない場合、リクエストは承認されていないと見なされます。詳細については、リクエストの承認をご覧ください。