指定区域端点

Cloud Translation 高级版提供欧盟地区 API 端点。如果您使用区域端点,则静态数据和机器学习处理会保留在欧盟的大陆边界内。如果必须控制数据的位置以符合当地法规的要求,则指定端点很重要。Cloud Translation 高级版欧盟区域 API 端点为 translate-eu.googleapis.com

与使用全球端点 (translate.googleapis.com) 相比,使用 EU 地区 API 端点有一些差异:

  • 不支持使用自定义 AutoML 模型的文本翻译。您只能使用预训练的 NMT 模型。
  • 不支持翻译格式化文档。
  • 不支持未正式发布(仍处于预览版阶段)的功能。
  • 通过全球端点进行的调用无法访问使用欧盟端点(其位置为 europe-west1)创建的资源。 同样,通过欧盟端点进行的调用无法访问使用全球端点创建的资源。

限制资源位置

组织政策管理员可通过创建资源位置限制条件来限制可用于 Cloud Translation 高级版资源的地区。

用法示例

以下示例展示了使用地区端点的文本翻译。如果您使用客户端库,请将 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 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"
    }
  ]
}