上限と割り当ては、自動プロセスが Admin Settings API を不適切な方法で使用することを防ぎ、Google のインフラストラクチャを保護します。API からの過剰なリクエストは、無害な入力ミスが原因である場合もあれば、不必要に API 呼び出しを行う非効率的な設計のシステムが原因である場合もあります。こうした原因とは無関係に、Google Workspace システムの全体的な正常性を維持するには、特定のソースからのトラフィックが一定のレベルに達した場合にトラフィックをブロックする必要があります。つまり、あるデベロッパーの操作によってコミュニティに悪影響が及ぶ事態を防ぎます。
API リクエストが失敗した場合は、HTTP ステータス コード レスポンスが返されます。ステータス コード 403 には、入力が正しくないというエラー情報が含まれています。HTTP ステータス コード 503 には、どの API 割り当てが超過したかを示すエラー情報が含まれています。これらのレスポンスにより、カスタム アプリケーションはこれらのエラーを検出し、適切なアクションを実行できます。
リクエストを一定期間内に完了する必要がある場合は、リクエストを並行して送信するか、Java または C# アプリケーションで複数のスレッドを使用します。たとえば、リクエストを月単位などの期間で分割します。スレッドの場合は、リクエストごとに 1 つのスレッドを使用して、10 個のスレッドから開始してみてください。なお、スレッドの推奨事項にはトレードオフがあり、すべての API の状況で有用とは限りません。リクエストの数が多すぎると、割り当てエラーが発生します。
時間ベースのエラー（スレッドあたり X 秒で最大 N 個）すべて、特に 503 ステータス コードエラーについては、コードで例外をキャッチし、指数バックオフ アルゴリズムを使用して、失敗した呼び出しを再試行する前に少し待つことをおすすめします。1 つのスレッドの Email Settings API の例では、5 秒間待機してから失敗した呼び出しを再試行します。リクエストが成功したら、他のスレッドについてもこのパターンを繰り返します。2 回目のリクエストが成功しなかった場合、呼び出しが成功するまで、アプリケーションはリクエストの頻度を減らす必要があります。たとえば、最初の 5 秒の遅延を 10 秒に増やして、失敗した呼び出しを再試行します。また、再試行の制限も決定します。たとえば、アプリケーションがユーザーにエラーを返す前に、異なる遅延時間でリクエストを 5 ～ 7 回再試行します。
| API 割り当てカテゴリ | 割り当て |
|---|---|
| ClientLogin 認証トークン | 24 時間有効です。エラーは「401 token expired」です。 |
| 公開鍵と秘密鍵の生成 |
ID プロバイダで、DSA または RSA のアルゴリズムを使用して公開鍵と秘密鍵のペアを生成します。公開鍵は X.509 形式の証明書に含まれています。SAML ベースのシングル サインオン署名鍵の詳細については、Google Workspace シングル サインオン サービスの鍵と証明書を生成するをご覧ください。 |
| ロゴ |
アカウントのロゴ画像ファイルは、JPEG、PNG、GIF のいずれかの形式にできます。推奨サイズは 143 x 59 ピクセルで、ファイルサイズは 20 KB 未満にする必要があります。カスタムロゴを使用する際は、Google の利用規約の範囲内で使用してください。また、Google や Gmail などの Google のロゴは使用しないでください。詳しくは、ロゴとランディング ページのポリシーをご覧ください。 |
| ssoWhitelist |
ssoWhitelist は、クラスレス ドメイン間ルーティング （CIDR）形式のネットワーク マスク IP アドレスです。 |
| その他の種類の制限 | 制限事項とガイドライン |
|---|---|
| MX レコードの確認ステータス |
デフォルトの MX レコードの確認ステータスは `false` です。これは、Google システムが最近 MX レコードの構成を確認していないか、MX レコードが Google システムを参照するように構成されていないことを意味します。レコードを更新しても確認ステータスが false のままの場合は、MX レコードの更新が伝播されていないか、レコードに誤字脱字がある可能性があります。伝播については、MX レコードの有効期間（TTL）値で定義された時間待ってから、再度試すことをおすすめします。 |
| 国コード |
組織名がカスタマイズされていない場合、デフォルトはプライマリ ドメイン名です。組織名の文字については、文字の使用をご覧ください。 |
creationTime プロパティ、日付と時刻の数値表現 |
ISO 8601 の日付と時刻の数値表現をご覧ください。 |
| 言語エンコーディング タグ |
Google メールで受け入れられる RFC 3066 言語タグをご覧ください。 |
| 組織名 |
組織名がカスタマイズされていない場合、デフォルトはプライマリ ドメイン名です。組織名の文字については、文字の使用をご覧ください。 |
プロジェクトごとの割り当ての増加をリクエストする
プロジェクトのリソース使用量に応じて、割り当ての調整をリクエストできます。サービス アカウントによる API 呼び出しは、単一のアカウントを使用していると見なされます。割り当ての調整を申請しても、必ずしも承認されるとは限りません。割り当て値を大幅に増やす割り当て調整リクエストは、承認に時間がかかることがあります。
割り当て量はすべてのプロジェクトで同じとは限りません。Google Cloud の使用量が多くなるに伴い、割り当て値を増やす必要が生じることがあります。使用量の大幅な増加が見込まれる場合は、事前に Google Cloud コンソールの割り当てページから割り当ての調整をリクエストできます。
詳細については、次のリソースをご覧ください。