全域和多區域端點

Cloud Translation - Advanced 提供全球端點，以及歐盟和美國多區域端點：

  • translate.googleapis.com (全球)
  • translate-eu.googleapis.com
  • translate-us.googleapis.com

如果您使用多區域端點，靜態資料和機器學習處理程序會留在歐盟或美國的大陸邊界內。如果必須控管資料位置，才能遵守當地法規要求，這些多區域端點就非常重要。

如果您未指定端點，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 方法和網址：

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