制限と割り当てにより、Groups Migration API を不適切な方法で使用する自動プロセスから Google インフラストラクチャが保護されます。API からの過剰なリクエストは、無害なタイプミスや、不必要な API 呼び出しを行う非効率的な設計のシステムにより発生する可能性があります。原因に関係なく、Google Workspace システム全体の健全性のために、特定のレベルに達した特定のソースからのトラフィックをブロックする必要があります。
API リクエストの失敗
万が一 API リクエストが失敗すると、アプリケーションは HTTP ステータス コード レスポンスを受信します。HTTP ステータス コード 403 には入力の誤りに関するエラー情報が含まれ、HTTP ステータス コード 503 には超過した API 割り当てを示すエラー情報が含まれます。これらのレスポンスにより、カスタム アプリケーションでこれらのエラーを検出して適切な措置を講じることができます。
時間的制約のあるリクエスト
リクエストを一定の時間内に完了する必要がある場合は、リクエストを並行して送信するか、Java または C# アプリケーションで複数のスレッドを使用します。たとえば、月または別の期間でリクエストを分割します。スレッドの場合は、10 スレッド（リクエストごとに 1 スレッド）から始めてください。スレッドの推奨事項にはトレードオフがあり、API のすべての状況に役立つわけではありません。リクエストの数が多すぎると、割り当てエラーが発生します。
時間ベースのエラー
時間ベースのすべてのエラー（スレッドあたり最大 X 秒間、最大 N 個）、特に 503 ステータス コード エラーについては、コードで例外をキャッチし、指数バックオフ アルゴリズムを使用してわずかな遅延を待ってから、失敗した呼び出しを再試行することをおすすめします。1 つのスレッドでの Groups Migration API の例としては、5 秒待ってから、失敗した呼び出しを再試行します。リクエストが成功したら、他のスレッドにこのパターンを繰り返します。2 番目のリクエストが成功しなかった場合、呼び出しが成功するまでアプリはリクエストの頻度でスケールダウンする必要があります。たとえば、最初の 5 秒の遅延を 10 秒に増やしてから、失敗した呼び出しを再試行します。また、再試行の上限も決定します。] たとえば、遅延時間を変えてリクエストを 5 ～ 7 回再試行すると、アプリがユーザーにエラーを返します。
上限
| API 上限のカテゴリ | 上限 |
|---|---|
| 秒間クエリ数（QPS） | デベロッパー プロジェクトでは、アカウントごとの秒間クエリ数（QPS）の上限は 10 件です。 |
割り当て
| API 割り当てカテゴリ | 割り当て |
|---|---|
| 1 日あたりの最大 API リクエスト数 | 1 日あたりの最大 API リクエスト数は 500,000 件です。 |
| メールのアーカイブ、有効期限 | グループのアーカイブに有効期限はありません。メッセージはグループが削除されるまでアーカイブに残ります。メール保持ポリシーは、グループのアーカイブ内のメッセージには影響しません。 |
| メール メッセージのサイズ | メール メッセージの最大サイズは 25 MB です。この上限には、メッセージのメタデータ ヘッダー、本文、添付ファイルが含まれます。 |
その他の種類の制限
| その他の制限 | 制限事項とガイドライン |
|---|---|
| コンテンツ タイプの形式 | メール メッセージは、標準の RFC 822 テキスト形式である必要があります。移行したメールをアップロードする場合、リクエストのコンテンツ タイプに Content-type: message/rfc822 ヘッダーを使用する必要があります。 |
| API レスポンスのデータ形式 | レスポンスのデータ形式は JavaScript Object Notation（JSON）です。 |
| データのロケーションに関するポリシー | Groups Migration API は、契約上の理由により、特定の地理的境界または行政境界にデータを保存することを求めるデータ ロケーション ポリシーをサポートしていません。アカウントでデータのロケーションが必要な場合は、Groups Migration API を使用しないでください。 |
| 並列メッセージ挿入 | Groups Migration API では、異なるグループ アーカイブへのメールの挿入リクエストを同時に実行できます。ただし、Groups Migration API は、同じグループ アーカイブへの並列メッセージ挿入をサポートしていません。また、このバージョンの Groups Migration API ではバッチ リクエストはサポートされていません。 |
| 未承認のリクエスト | Groups Migration API は未承認のリクエストを受け付けません。認証トークンが指定されていない場合、リクエストは不正とみなされます。詳細については、認証と認可の詳細をご覧ください。 |