라벨을 사용하여 사용량 보고(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 메서드 및 URL:

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 결제 콘솔의 보고서 뷰로 이동하여 이 라벨을 요청 사용량 확인을 위한 필터로 사용합니다.

대시보드 왼쪽 상단에 있는 버거 아이콘을 클릭하고 드롭다운에서 '결제'를 선택합니다. 결제 계정이 여러 개이면 선택하라는 메시지가 표시됩니다. '연결된 결제 계정으로 이동'을 클릭합니다.
결제 페이지의 왼쪽 탐색 메뉴에서 보고서를 선택합니다.
오른쪽 탐색 메뉴에서 필터를 사용하여 요청 사용량을 확인합니다.