Cloud Translation では、リクエストのコンテンツ サイズと送信できるリクエストの数に対して割り当てが適用されます。割り当てを適用することで、予期しない使用量の急増を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当てを低くして、過剰な使用を防ぎ、費用を管理することもできます。
割り当てを超過すると、Cloud Translation から 403 エラーが返されます。1 日の割り当てを超えた場合は、「Daily Limit Exceeded」というエラー メッセージが返され、分単位の割り当てを超えた場合は、「User Rate Limit Exceeded」というエラー メッセージが返されます。
1 日の割り当ては午前 0 時（太平洋時間）にリセットされます。そのため、新しい割り当てが有効になるまでに最大 24 時間かかることがあります。
使用量の割り当ての設定
デフォルトでは、1 日あたりに送信できる文字数に上限はありません。予算を設定している場合は、毎日の使用量をモニタリングし、計画された費用に基づいて割り当てを調整することをおすすめします。
割り当てを編集するには、Google Cloud コンソールの割り当てページを使用します。v2 の割り当ては Cloud Translation - Basic に適用され、v3 の割り当ては Cloud Translation - Advanced に適用されます。
コンテンツの割り当て
コンテンツの割り当ては、translateText、detectLanguage、translateDocument の各メソッドの同期リクエストに適用されます。バッチテキスト翻訳などの非同期リクエストの場合、リクエストの割り当てのみが適用されます。
Cloud Translation API に送信するすべての文字（空白文字を含む）が、コンテンツの割り当てにカウントされます。Cloud Translation - Basic と Cloud Translation - Advanced を一緒に使用した場合、これらの割り当ては累積されます。
テキスト翻訳の場合、カスタムモデルの割り当ては別途カウントされ、一般的なモデルの割り当てにはカウントされません。ただし、1 つのプロジェクトから 1 日にリクエストできるカスタムモデルの数には上限があります。
| 割り当て | Default |
|---|---|
| 1 日あたりプロジェクトごとに一般的なモデルに送信される文字数（v2 と v3） | unlimited |
| 1 プロジェクトあたり 1 分ごとに一般的なモデルに送信される文字数（v2 および v3） | 6,000,000 |
| 1 プロジェクトあたり 1 分ごとに 1 ユーザーによって一般的なモデルに送信される文字数（v2 および v3） | 6,000,000 |
| 1 プロジェクト、1 分あたり文字変換のために送信された文字数（v3） | 100,000（また、1 プロジェクトあたり 1 分あたりの割り当てで一般的なモデルに送信される文字数にカウントされます） |
| 1 プロジェクト、1 分あたりローマ字化のために送信される文字数（v3） | 100,000 |
| 1 プロジェクトあたり 1 分ごとにカスタムモデルに送信される文字数（v3） | 100,000 |
| 1 プロジェクトあたり 1 分ごとに 1 ユーザーによってカスタムモデルに送信される文字数（v3） | プロジェクトの上限まで |
| 1 プロジェクト、1 日あたりに呼び出された一意のカスタムモデルの数（v3） | 30 |
| ドキュメント翻訳について、1 プロジェクトあたり 1 分ごとに送信されるページ数（v3） | 2,400 |
| ドキュメント翻訳について、1 プロジェクトあたり 1 分ごとに 1 ユーザーによって送信されるページ数（v3） | 2,400 |
ユーザーごとの割り当ては、エンドユーザーがクライアント アプリケーションを使って 1 分あたりに送信できるリクエスト数に適用されます。サービス アカウントを使用する場合、サービス アカウントの ID が割り当ての対象となるユーザーです。Cloud Translation - Basic と API キーを使用する場合は、この上限を適用するために Cloud Translation でクライアントの IP アドレスが使用されます。
リクエストあたりのコンテンツの上限
Cloud Translation API は短いリクエストの翻訳向けに最適化されています。リクエストの長さの推奨上限は、1 リクエストあたり 5,000 文字（コードポイント）です。ただし、含める文字数が多くなるほど、レスポンスのレイテンシが高くなります。Cloud Translation - Advanced の場合、1 リクエストあたりの最大コードポイント数は 30,000 です。Cloud Translation - Basic は最大リクエスト サイズが 10 万バイトです。もう 1 つの方法は、一括翻訳を使用し、長時間実行オペレーションとしてリクエストごとにより多くのコンテンツを送信することです。
利用可能な割り当てにかかわらず、上限を超えるリクエストは Cloud Translation API によって拒否され、400 INVALID_ARGUMENT エラーが発生します。
リクエストの割り当て
Cloud Translation では、サービスに送信できるリクエストの数に対して割り当てが適用されます。 これらの割り当ては、translateDocument メソッドと getSupportedLanguages メソッド（独自のリクエストまたはコンテンツの割り当てがあります）を除く、すべての Cloud Translation のメソッド呼び出しに適用されます。
カスタムモデルの割り当ては個別にカウントされ、他の v3 リクエストの割り当てにはカウントされません。
| 割り当て | Default |
|---|---|
| 1 プロジェクトあたり 1 分ごとに送信されるサポートされている言語の取得に関するリクエスト（v2 と v3 の組み合わせ）数 | 600 |
| 1 プロジェクト、1 分あたりの v2 リクエスト数 | 300,000 |
| 1 プロジェクト、1 分、1 ユーザーあたりの v2 リクエスト数 | v2 プロジェクトの上限まで |
| 1 プロジェクト、1 分あたりの v3 リクエスト数 | 6000 |
| 1 プロジェクト、1 分あたりの v3 ローマ字化リクエスト数 | 6000 |
| 1 プロジェクト、1 分、1 ユーザーあたりの v3 リクエスト数 | v3 のプロジェクト上限まで |
| 1 プロジェクト、1 日あたりの v3 一括翻訳リクエスト（テキストとドキュメント）数 | unlimited |
| 1 プロジェクト、1 日あたりの v3 カスタムモデル翻訳リクエスト数 | unlimited |
| 1 プロジェクト、1 分あたりの v3 カスタムモデル翻訳リクエスト数 | 600 |
| 1 プロジェクト、1 日あたりの v3 カスタムモデル一括翻訳リクエスト数 | unlimited |
| 1 プロジェクト、1 分あたりの v3 モデル作成リクエスト数 | 10 |
| 1 プロジェクトあたりの v3 モデル同時作成リクエスト数 | 2 |
ユーザーごとの割り当ては、エンドユーザーがクライアント アプリケーションを使用して 1 分あたりに送信できるリクエスト数に適用されます。サービス アカウントを使用する場合、サービス アカウントの ID が割り当ての対象となるユーザーです。Cloud Translation - Basic と API キーを使用する場合は、この上限を適用するために Cloud Translation でクライアントの IP アドレスが使用されます。
割り当てのカウント
Cloud Translation - Basic の場合、コンテンツとリクエストの割り当ては、リクエストを行うプロジェクトに対してカウントされます（リクエストで使用されるキーにより決定）。
Cloud Translation - Advanced の場合、コンテンツの割り当ては、リクエストのモデルに関連付けられているプロジェクトに対してチェックされます。リクエストの割り当ては、リクエストを行うプロジェクトに対してチェックされます。
たとえば、次のテキストの翻訳のリクエストでは、リクエストが project-id-1 から来ているため、project-id-1 に対してチェックされます。コンテンツの割り当ては、project-id-2 に対してチェックされます。このプロジェクトのモデルが使用されているためです。
POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText { "Model":"projects/project-id-2/locations/us-central1/models/model-id", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash."] }
Cloud Translation - Advanced に関する上限
次の表は、Cloud Translation - Advanced に関する上限を示しています。この上限は変更できません。
| 説明 | 上限 |
|---|---|
| 1 つの一括リクエストに含めることができるファイルの最大数 | 100 ファイル |
| 1 プロジェクトに使用できる用語集リソースの最大数 | 10,000 |
適応型翻訳
| 説明 | 上限 |
|---|---|
| インポートできるセグメントペアの最大数 | 10,000（Google Cloud コンソール） 30,000（API） |
| 1 回のリクエストで送信できる最大文字数 | 3,000 |
| 1 回のリクエストで適応型翻訳から出力される最大文字数 | 言語の場合は 3,000 文字（この上限を超えるテキストは破棄されます） |