制限と割り当てにより、Email Audit API を不適切な方法で使用する自動プロセスから Google のインフラストラクチャが保護されます。API から過剰なリクエストが発生すると、無害なタイプミスや、不必要な API 呼び出しを行う非効率的な設計システムによる結果になることがあります。原因にかかわらず、特定のソースからのトラフィックが特定のレベルに達したときに、Google Workspace システムの全体的な健全性を維持する必要があります。制限により、1 つのデベロッパーのアクションが大規模なコミュニティに悪影響を与えることを防止できます。
API リクエストが失敗した場合、HTTP ステータス コード レスポンスが返されます。403 のステータス コードには誤った入力に関するエラー情報があり、503 の HTTP ステータス コードにはどの API 割り当てを超過したかを示すエラー情報があります。これらのレスポンスにより、カスタム アプリはこれらのエラーを検出し、適切なアクションを実行できます。
一定期間内にリクエストを完了する必要がある場合は、リクエストを並行して送信するか、Java または C# アプリケーションで複数のスレッドを使用します。並行リクエストの例としては、1 人のユーザーに大量のメールを一括して追加または削除するのではなく、異なるユーザーからのメールを一括送信するというものがあります。スレッドの場合は、1 スレッドあたり 1 スレッド、なお、スレッドの推奨事項にはトレードオフがあり、すべての API 状況で役立つわけではありません。リクエスト数が多すぎる場合、割り当てエラーが発生します。もう 1 つのトレードオフの例は、最大メッセージ アップロード速度に対する Email Audit API の割り当てです。アップロード速度は、アップロード リクエストを作成するスレッドの数に関係なく、ユーザーごとに 1 秒あたり 1 つの API リクエストになります。
時間ベースのすべてのエラー（スレッドあたり N 秒間の最大 N 個のエラー）で、特に 503 ステータス コードエラーの場合は、コードで例外を捕捉し、指数バックオフ アルゴリズムを使用して、少し待ってから呼び出しを再試行することをおすすめします。1 つのスレッドの Email Audit API の例は、5 秒間待機して、失敗した呼び出しを再試行します。リクエストが成功したら、他のスレッドにもこのパターンを繰り返します。2 番目のリクエストが失敗した場合、アプリケーションは呼び出しが成功するまでリクエストの頻度に基づいてスケールダウンします。たとえば、最初の 5 秒の遅延を 10 秒に増やして、失敗した呼び出しを再試行します。また、再試行の上限を決定します。たとえば、異なるエラー時間で 5 ～ 7 回リクエストを再試行してから、アプリケーションがユーザーにエラーを返します。
次の表に、Email Audit API の上限を示します。
| API 制限カテゴリ | 制限事項 |
|---|---|
| 暗号化されたメールボックス ファイル、作成 | サイズによっては、暗号化されたメールボックス ファイルの作成に数日かかることもあります。 |
| 暗号化されたメールボックス ファイル、削除時のエラー | 暗号化されたメールボックスの削除でエラーが発生すると、リクエストのステータスは MARKED_DELETE になります。これらのサマリー ファイルとエクスポート ファイルは、24 時間以内に Google によって自動的に削除されます。MARKED_DELETE のステータスが常に返される場合は、指数バックオフ方式を試してください。 |
次の表に、Email Audit API の割り当てを示します。
| API 割り当てカテゴリ | 割り当て |
|---|---|
| SafeFrame 認証トークン | 24 時間有効です。エラーは 401 token expired です。 |
| 日付形式 | Email Audit API で使用する前に、すべての日付を協定世界時（UTC）形式に変換します。詳細については、UTC コンバータをご覧ください。 |
暗号化されたメールボックス ファイル、EXPIRED の概要、ファイルのエクスポート
|
Google は、暗号化されたメールボックス ファイルを 3 週間保持します。猶予期間が過ぎると、削除されます。この期間が経過するまで、このメールボックス ファイルのダウンロードはドメイン管理者の責任です。 |
| 暗号化されたメールボックス ファイル、形式 | 暗号化されたメールボックス ファイルは mbox 形式です。 |
| 暗号化されたメールボックス ファイル、最大作成リクエスト | 1 日のメールボックス エクスポート作成リクエストの最大数は、ドメイン内のすべての管理者からの 100 件です。 |
| 暗号化されたメールボックス ファイルのステータス、ページ分け | すべてのメールボックス リクエストのステータスをリクエストすると、レスポンスで大量のデータが返されることがあります。Email Audit API は、このデータをページごとにバッチ処理します。各ページには最大 100 個のエントリが含まれ、link rel='next' タグ内の URI は結果の次のページを指します。クライアント アプリケーションの開発では、これらの追加結果をコードで管理する必要があります。
|
| メール モニター | 1 日あたりのメール モニタリング リクエストの最大数は 1,500 です。この上限はドメインに適用され、その日にすべての管理者が行ったすべてのリクエストが含まれます。 |
| 公開鍵 | Email Audit API では鍵を 1 つだけサポートします。 公開鍵は、GNU Privacy Guard（GPG）ソフトウェアを使用しています。これは PGP 形式であり、ASCII でエンコードされた RSA 暗号鍵です。公開鍵をアップロードする前に、まず Base64 でエンコードされた文字列に変換する必要があります。公開鍵ファイルは US-ASCII 文字（IANA は ASCII 推奨文字セット）で読み取る必要があります。 |
| 検索機能 | searchQuery パラメータと includeDeleted パラメータは相互に排他的です。includeDeleted="true" の場合、検索クエリは実行できません。 |