リージョンエンドポイントを指定する

Cloud Translation - Advanced は EU リージョンの API エンドポイントを提供しています。このリージョンエンドポイントを使用する場合、保存データと機械学習処理は EU の大陸境界内にとどまります。現地の規制要件に合わせてデータのロケーションを制御する必要がある場合は、エンドポイントの指定が重要となります。Cloud Translation - Advanced の EU リージョン API エンドポイントは translate-eu.googleapis.com です。

EU リージョン API エンドポイントを使用する場合とグローバルエンドポイント（translate.googleapis.com）を使用する場合には、いくつかの違いがあります。

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

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

組織のポリシーの管理者は、リソースロケーションの制約を作成することで、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 application-default print-access-token) \
-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 application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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"
    }
  ]
}

リージョン エンドポイントを指定する

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

使用例

REST とコマンドライン

curl

PowerShell

リージョンエンドポイントを指定する

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