Relatórios de utilização com etiquetas (avançado)

A API Cloud Translation suporta a adição de etiquetas definidas pelo utilizador (pares de chave-valor) a pedidos TranslateText, BatchTranslateText e DetectLanguage. As informações sobre a utilização de um pedido são encaminhadas para o sistema de faturação, onde pode discriminar os encargos de faturação filtrando por etiqueta.

Exemplo de utilização

Um exemplo de utilização importante das etiquetas envolve clientes que fornecem serviços de tradução a muitos clientes. Um único projeto pode ser usado para vários clientes. Para fins de faturação, é importante associar pedidos específicos aos respetivos clientes. É aqui que entram as etiquetas. Quando faz uma chamada em nome de um cliente, etiqueta o pedido com uma etiqueta específica do cliente. Estas etiquetas ficam disponíveis para fins de filtragem na secção Relatórios do Google Cloud.

Requisitos para etiquetas

As etiquetas aplicadas a um pedido têm de cumprir os seguintes requisitos:

• Cada pedido pode ter várias etiquetas, até um máximo de 64.
• Cada etiqueta tem de ser um par chave-valor.
• As chaves têm um comprimento mínimo de 1 caráter e um comprimento máximo de 63 carateres, e não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 carateres.
• As chaves e os valores contêm apenas letras minúsculas, carateres numéricos, sublinhados e travessões. Todos os carateres têm de usar a codificação UTF-8, e são permitidos carateres internacionais.
• A parte principal de uma etiqueta tem de ser exclusiva num único pedido (por exemplo, {'country':'india'} é aceitável, mas {'country':'india','country':'sweden'} não é permitido).
• As chaves têm de começar com uma letra minúscula ou um caráter internacional.

Etiquetas e faturação

No Cloud Translation, pode usar etiquetas para organizar as taxas por conta de faturação. Não lhe é cobrado o uso de etiquetas do Cloud Translation.

As taxas estão associadas à conta de faturação do projeto que contém o pedido. Em alternativa, se for usado um modelo personalizado ou de tradução automática neural (NMT), são cobradas taxas associadas ao projeto que contém o modelo.

Para fins de faturação, todos os pedidos faturáveis podem ter as suas próprias etiquetas. Estes pedidos faturáveis incluem tradução em lote, deteção de idioma e tradução de texto.

Criar e gerir etiquetas através da API Cloud Translation

Use a API Cloud Translation para adicionar etiquetas a um pedido.

REST

No exemplo seguinte, as etiquetas {'country':'russia'} e {'env':'test'} são adicionadas ao pedido translateText.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do seu Google Cloud projeto

Método HTTP e URL:

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

Corpo JSON do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Deve receber uma resposta JSON semelhante à seguinte:

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

Relatório de preços

Aceda à vista Google Cloud relatórios da consola de faturação para usar estas etiquetas como filtros para a utilização de pedidos.

1. No painel de controlo, clique no ícone de menu (hambúrguer) no canto superior esquerdo e selecione "Faturação" no menu pendente. Se tiver várias contas de faturação, é apresentada uma página que lhe pede para fazer uma seleção. Clique em "Aceder à conta de faturação associada".
2. Na página Faturação, selecione Relatórios na navegação do lado esquerdo.
3. Use os filtros na navegação do lado direito para verificar a utilização de pedidos.