制限や割り当てを設定すると、Admin Settings API を不適切な方法で使用する自動プロセスから Google のインフラストラクチャが保護されます。API から過剰なリクエストが発生すると、有害なタイプミスが発生したり、不必要な API 呼び出しを行う非効率的なシステムが原因で発生する可能性があります。原因にかかわらず、特定のソースからのトラフィックが特定のレベルに達したときに、Google Workspace システムの全体的な健全性を維持する必要があります。これにより、1 人のデベロッパーの行動がより大きなコミュニティに悪影響を与えることを防止できます。
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 割り当てカテゴリ | 割り当て |
|---|---|
| SafeFrame 認証トークン | 24 時間有効です。エラーは「401 tokenexpire」です。 |
| 公開鍵と秘密鍵の生成 | ID プロバイダで、DSA または RSA のアルゴリズムを使用して公開鍵と秘密鍵のセットを生成します。公開鍵は X.509 形式の証明書です。SAML ベースのシングル サインオン署名鍵について詳しくは、Google Workspace シングル サインオン サービス用の鍵と証明書の生成をご覧ください。 |
| ロゴ | アカウントのロゴ画像のファイルは、JPEG、PNG、GIF のいずれかの形式を使用できます。推奨サイズは 143x59 ピクセルで、ファイルは 20 KB 未満にする必要があります。カスタムロゴを使用する際は、必ず Google 利用規約を遵守してください。Google ロゴや Gmail ロゴ、その他の Google ロゴは使用しないでください。詳しくは、ロゴとランディング ページに関するポリシーをご覧ください。 |
| sso ホワイトリスト | sso ホワイトリストは、クラスレスドメイン間ルーティング（CIDR）形式のネットワークマスク IP アドレスです。 |
| その他の種類の制限 | 制限事項とガイドライン |
|---|---|
| MX レコードの確認ステータス | デフォルトの MX レコード確認ステータスは「false」です。これは、Google システムが最近 MX レコードの設定を確認していないか、MX レコードが Google システムを参照するように設定されていないことを意味します。レコードを更新しても確認ステータスが false のままである場合は、MX レコードの更新が反映されていないか、レコードにタイプミスがある可能性があります。反映されるには、MX レコードの有効期間値（TTL）で定義された時間待ってから、もう一度お試しください。 |
| 国コード | 組織名がカスタマイズされていない場合、デフォルトはプライマリ ドメイン名になります。組織名の文字について詳しくは、文字の使用をご覧ください。 |
creationTime プロパティ、日付と時刻の数値表現 |
日付と時刻の数値表現については、ISO 8601 をご覧ください。 |
| 言語エンコード タグ | Google Mail で利用できる RFC 3066 の言語タグをご確認ください。 |
| 組織の名称 | 組織名がカスタマイズされていない場合、デフォルトはプライマリ ドメイン名になります。組織名の文字について詳しくは、文字の使用をご覧ください。 |