Informa el uso con etiquetas (avanzado)

La API de Cloud Translation permite agregar etiquetas definidas por el usuario (pares clave-valor) a solicitudes TranslateText, BatchTranslateText y DetectLanguage. La información sobre el uso de una solicitud se envía al sistema de facturación, en el que puedes desglosar los cargos de facturación si filtras por etiqueta.

Caso práctico

Un caso práctico importante para las etiquetas incluye a los clientes que brindan servicios de traducción a muchos clientes. Se puede usar un solo proyecto para varios clientes. Para fines de facturación, es importante asociar las solicitudes específicas con sus respectivos clientes. Allí es donde entran las etiquetas. Cuando realizas una llamada en nombre de un cliente, debes etiquetar la solicitud con una etiqueta específica del cliente. Luego de esto, las etiquetas estarán disponibles para fines de filtrado en la sección Informes de Google Cloud.

Requisitos para las etiquetas

Las etiquetas que se apliquen a una solicitud deben cumplir con los siguientes requisitos:

• Cada solicitud puede tener varias etiquetas, hasta un máximo de 64.
• Cada etiqueta debe ser un par clave-valor.
• Las claves deben tener una longitud mínima de 1 carácter y un máximo de 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y su longitud máxima es de 63 caracteres.
• Las claves y los valores solo contienen letras minúsculas, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar la codificación UTF-8 y, también, se permiten los caracteres internacionales.
• La parte de la clave de una etiqueta debe ser única dentro de una sola solicitud (por ejemplo, {'country':'india'} está bien, pero {'country':'india','country':'sweden'} no se permite).
• Las claves deben comenzar con una letra en minúscula o un carácter internacional.

Etiquetas y facturación

En Cloud Translation, puedes usar etiquetas para organizar las tarifas por cuenta de facturación. No se te cobrará por el uso de etiquetas de Cloud Translation.

Las tarifas están asociadas con la cuenta de facturación del proyecto que contiene la solicitud. O bien, si se usa un modelo personalizado o de traducción automática neuronal (NMT), las tarifas se asocian con el proyecto que contiene el modelo.

Para la facturación, todas las solicitudes facturables pueden tener etiquetas propias. Estas solicitudes facturables incluyen traducción por lotes, detección de idioma y traducción de texto.

Crea y administra etiquetas con la API de Cloud Translation

Usa la API de Cloud Translation para agregar etiquetas a una solicitud.

REST

En el siguiente ejemplo, se agregan las etiquetas {'country':'russia'},{'env':'test'} a la solicitud translateText.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_NUMBER_OR_ID: el ID numérico o alfanumérico del proyecto de Google Cloud

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Informe de precios

Ve a vista de Informes de la consola de facturación de Google Cloud si deseas usar estas etiquetas como filtros para el uso de solicitudes.

1. En el panel, haz clic en el ícono de tres barras en la parte superior izquierda y selecciona “Facturación” en el menú desplegable. Si tienes varias cuentas de facturación, aparecerá una página que te solicitará que selecciones una. Haz clic en “Ir a la cuenta de facturación vinculada”.
2. En la página Facturación, selecciona Informes en el panel de navegación izquierdo.
3. Usa los filtros del panel de navegación derecho para verificar el uso de solicitudes.