グローバル エンドポイントとマルチリージョン エンドポイント

Cloud Translation - Advanced は、グローバル エンドポイント、EU および米国のマルチリージョン エンドポイントを提供しています。

  • translate.googleapis.com（グローバル）
  • translate-eu.googleapis.com
  • translate-us.googleapis.com

マルチリージョン エンドポイントを使用する場合、保存データと機械学習処理は EU または米国の大陸境界内にとどまります。これらのマルチリージョンのエンドポイントは、現地の規制要件に合わせてデータのロケーションを制御する必要がある場合に重要となります。

エンドポイントを指定しない場合、Cloud Translation - Advanced はデフォルトでグローバル エンドポイントを使用します。

グローバル エンドポイントとマルチリージョン エンドポイント

マルチリージョン エンドポイントを使用する場合は、グローバル エンドポイントを使用する場合とは違います。

  • カスタム AutoML モデルを使用するテキスト翻訳はサポートされていません。事前トレーニング済みの NMT モデルのみを使用できます。
  • 一般提供されていない（プレビュー版の）機能はサポートされていません。
  • グローバル エンドポイントを介した呼び出しでは、マルチリージョン エンドポイントを使用して作成されたリソースにアクセスできません。同様に、マルチリージョン エンドポイントを介した呼び出しでも、グローバル エンドポイントを使用して作成されたリソースにはアクセスできません。

リソース ロケーションの制限

組織のポリシーの管理者は、リソース ロケーションの制約を作成することで、Cloud Translation - Advanced リソースで使用できるリージョンを制限できます。このように設定すると、Cloud Translation - Advanced のユーザーは、特定のロケーションにのみリソースを作成できます。

エンドポイントを指定する

次の例は、マルチリージョン エンドポイントを使用するテキスト翻訳を示しています。クライアント ライブラリを使用する場合は、クライアント オプションの一部として API エンドポイントを設定します。例については、Cloud Natural Language API ガイドのクライアント ライブラリを使用してロケーションを設定するをご覧ください。

REST

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT_NUMBER_OR_ID: Google Cloud プロジェクトの数字または英数字の ID
  • ENDPOINT: データが存在するリージョンを決定するリージョン エンドポイント。例: translate-eu.googleapis.com
  • LOCATION: このオペレーションを実行するリージョン。リージョン エンドポイントの大陸境界内のリージョンを選択する必要があります。たとえば、translate-eu.googleapis.com エンドポイントを使用する場合は、europe-west1 などのヨーロッパのリージョンを指定します。

HTTP メソッドと URL:

POST https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText

リクエストの本文（JSON）: 

{
  "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "de",
  "contents": ["Come here!"]
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "translations": [
    {
      "translatedText": "Komm her!",
      "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base"
    }
  ]
}