使用標籤回報使用情形 (進階)

Cloud Translation API 支援在 TranslateText、BatchTranslateText 和 DetectLanguage 要求中加入使用者定義的標籤 (鍵/值組)。系統會將要求的用量資訊轉送至帳單系統，方便您依據標籤篩選條件查看帳單費用明細。

用途

標籤的重要用途之一，是協助為多位客戶提供翻譯服務的客戶。單一專案可供多位客戶使用。為方便計費，請務必將特定要求與各自的客戶建立關聯。這時標籤就派上用場。代表用戶端發出呼叫時，請使用用戶端專屬標籤標示要求。這些標籤隨後可用於 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 在要求中加入標籤。

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

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

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"

$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

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

價格報表

前往帳單控制台的「報表」Google Cloud檢視畫面，即可使用這些標籤做為篩選器，查看要求用量。

1. 在資訊主頁中，按一下左上角的三橫線圖示，然後從下拉式選單中選取「帳單」。如果您有多個帳單帳戶，系統會顯示頁面，要求您進行選取。按一下「前往連結的帳單帳戶」。
2. 在「帳單」頁面中，選取左側導覽列中的「報表」。
3. 使用右側導覽列中的篩選器，即可查看要求的使用情況。