通过标签报告用量（高级版）

Cloud Translation API 支持向 TranslateText、BatchTranslateText、DetectLanguage 请求添加用户定义的标签（键值对）。有关请求用量的信息会传递到结算系统，您可以在该系统中按标签进行过滤来细分结算费用。

使用场景

标签的一个重要使用场景是客户向他们的许多客户提供翻译服务。一个项目可用于多个客户。为了进行结算，必须将特定的请求与各自的客户相关联。这正是标签的用武之地。代表客户调用 API 时，您可以为请求添加特定于客户的标签。随后，您可以在 Google Cloud 的报告部分中使用这些标签执行过滤。

标签要求

应用于请求的标签必须满足以下要求：

• 每个请求可以带有多个标签，最多 64 个。
• 每个标签都必须采用键值对形式。
• 键至少包含 1 个字符，最多包含 63 个字符，且不能为空。值可以为空，且最多包含 63 个字符。
• 键和值只能包含小写字母、数字字符、下划线和短划线。所有字符必须使用 UTF-8 编码，允许使用国际字符。
• 标签的键部分在单个请求中必须是唯一的（例如，您可以使用 {'country':'india'}，但不能使用 {'country':'india','country':'sweden'}）。
• 键必须以小写字母或国际字符开头。

标签和结算

在 Cloud Translation 中，您可以使用标签来按结算账号整理费用。您不会因为使用 Cloud Translation 标签而改变。

费用与包含请求的项目的结算账号相关联。或者，如果使用自定义或神经机器翻译 (NMT) 模型，则费用与包含该模型的项目相关联。

为了进行结算，所有可结算的请求都可以带有自己的标签。这些可结算的请求包括批量翻译、检测语言和翻译文本。

使用 Cloud Translation API 创建和管理标签

使用 Cloud Translation API 向请求添加标签。

REST

以下示例向 translateText 请求添加 {'country':'russia'}、{'env':'test'} 标签。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_NUMBER_OR_ID：您的 Google Cloud 项目的数字或字母数字 ID

HTTP 方法和网址：

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText

请求 JSON 正文：

{
  source_language_code: 'en',
  target_language_code: 'ru',
  contents: 'Dr. Watson, come here!',
  labels: {'country':'russia','env':'test'}
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "translations": [
    {
      "translatedText": "Доктор Ватсон, иди сюда!"
    }
  ]
}

价格报告

转到 Google Cloud 结算控制台的报告视图，将这些标签用作请求用量的过滤条件。

1. 在信息中心内，点击左上角的汉堡图标，然后从下拉列表中选择“结算”。如果您有多个结算账号，则系统会显示一个页面，要求您选择结算账号。点击“转至关联的结算账号”。
2. 在“结算”页面中，选择左侧导航栏中的报告。
3. 使用右侧导航栏中的过滤条件检查请求的用量。