使用標籤回報使用情形 (Advanced)

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 在要求中加入標籤。

REST

在以下範例中，標籤 {'country':'russia'},{'env':'test'} 會新增到 translateText 要求。

使用任何要求資料之前，請先更改下列內容：

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 帳單控制台的「報表」檢視畫面，即可使用這些標籤做為篩選器，查看要求使用情況。

在資訊主頁中，按一下左上方的漢堡圖示，然後從下拉式選單中選取「Billing」(帳單)。如果您有多個帳單帳戶，系統會顯示一個頁面，要求您選取帳戶。在這種情況下，請按一下「Go to linked billing account」(前往連結的帳單帳戶)。
在「Billing」(帳單) 頁面中，選取左側導覽列中的「Reports」(報表)。
使用右側導覽列中的篩選器，查看要求的使用情況。