割り当てと上限

Cloud Translation では、リクエストのコンテンツサイズと送信できるリクエストの数に対して割り当てが適用されます。割り当てを適用することで、予期しない使用量の急増を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当てを低くして、過剰な使用を防ぎ、費用を管理することもできます。

割り当てを超過すると、Cloud Translation から 403 エラーが返されます。1 日の割り当てを超えた場合は、「Daily Limit Exceeded」というエラーメッセージが返され、分単位の割り当てを超えた場合は、「User Rate Limit Exceeded」というエラーメッセージが返されます。

1 日の割り当ては午前 0 時（太平洋時間）にリセットされます。そのため、新しい割り当てが有効になるまでに最大 24 時間かかることがあります。

使用量の割り当ての設定

デフォルトでは、1 日あたりに送信できる文字数に上限はありません。予算を設定している場合は、毎日の使用量をモニタリングし、計画された費用に基づいて割り当てを調整することをおすすめします。

割り当てを編集するには、Google Cloud Console の割り当てページを使用します。v2 の割り当ては Cloud Translation - Basic に適用され、v3 の割り当ては Cloud Translation - Advanced に適用されます。

コンテンツの割り当て

コンテンツの割り当ては、translateText、detectLanguage、translateDocument の各メソッドの同期リクエストに適用されます。バッチテキスト翻訳などの非同期リクエストの場合、リクエストの割り当てのみが適用されます。

Cloud Translation API に送信されるすべての文字（空白文字を含む）が、コンテンツの割り当てにカウントされます。Cloud Translation - Basic と Cloud Translation - Advanced を一緒に使用した場合、これらの割り当ては累積されます。

テキスト翻訳の場合、カスタムモデルの割り当ては別途カウントされ、一般的なモデルの割り当てにはカウントされません。

割り当て	デフォルト
1 日あたりプロジェクトごとに一般的なモデルに送信される文字数（v2 と v3）	上限なし
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）	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 リクエストの割り当てにはカウントされません。

割り当て	デフォルト
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 一括翻訳リクエスト数（テキストとドキュメント）	上限なし
1 プロジェクト、1 日あたりの v3 カスタムモデル翻訳リクエスト数	上限なし
1 プロジェクト、1 分あたりの v3 カスタムモデル翻訳リクエスト数	600
1 プロジェクト、1 日あたりの v3 カスタムモデル一括翻訳リクエスト数	上限なし
1 プロジェクト、1 分あたりの v3 モデル作成リクエスト数	10
1 プロジェクトあたりの v3 モデル同時作成リクエスト数	2

割り当てのカウント

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
1 プロジェクトに使用できる用語集リソースの最大数	10,000

適応型翻訳

説明	上限
インポートできるセグメントペアの最大数	10,000（Google Cloud コンソール） 30,000（API）
1 回のリクエストで送信できる最大文字数	3,000
1 回のリクエストで適応型翻訳から出力される最大文字数	言語の場合は 3,000 文字（この上限を超えるテキストは破棄されます）