Vista geral da Cloud Translation API

A Cloud Translation API pode traduzir texto para mais de 100 pares de idiomas. Se não souber o idioma do texto de origem, a Cloud Translation API pode detetá-lo por si. Para ver uma lista de todos os idiomas suportados, consulte o artigo Idiomas suportados.

Como organização empresarial, pode incluir texto traduzido em fluxos de trabalho internos existentes. Por exemplo, pode ter uma equipa de apoio técnico global que recebe registos de clientes em vários idiomas diferentes. Pode adicionar a Cloud Translation API ao seu fluxo de trabalho para traduzir esses registos de clientes para o idioma falado pelos membros da sua equipa de apoio técnico. Ao usar a API Cloud Translation, melhora a eficiência geral da sua equipa de apoio técnico, uma vez que não precisa de traduzir manualmente o texto nem depender de outras pessoas.

A Cloud Translation API é dimensionada de forma integrada e permite traduções de carateres ilimitadas por dia. No entanto, existem restrições no tamanho do conteúdo para cada pedido e taxas de pedidos. Além disso, pode usar limites de quota para gerir o seu orçamento. Para mais informações, consulte o artigo Quotas e limites.

Edições e modelos da Cloud Translation API

A API Cloud Translation está disponível em duas edições diferentes, nomeadamente a edição Basic e a edição Advanced. Para ver uma lista das diferentes funcionalidades suportadas por cada um, consulte a comparação de edições.

Dá-lhe uma escolha de modelos, para que possa escolher um adequado à sua aplicação específica.

API Cloud Translation - Basic

A edição Basic é acedida através das bibliotecas cliente v2, e requer uma configuração mínima, aceitando chaves de API para autenticação bem como contas de serviço. Só dá acesso ao modelo de tradução automática neural (NMT) da Google não modificado. É adequado para aplicações que precisam de traduzir conteúdo gerado pelo utilizador casual, como conversas, redes sociais ou comentários.

Se estiver a planear um novo projeto, recomendamos que escolha a edição Advanced em vez da edição Basic para tirar partido de uma melhor segurança, mais funcionalidades e das novas melhorias do serviço que a edição Advanced vai continuar a implementar no futuro.

API Cloud Translation – Advanced

A edição avançada é acedida através das bibliotecas de cliente v3 e requer a autenticação da conta de serviço integrada com as funções do IAM. Oferece uma escolha de modelos, incluindo o modelo LLM de tradução (TLLM) mais recente, bem como o modelo NMT com e sem personalização. Também oferece funcionalidades como glossários, tradução em lote, tradução de documentos e muito mais:

  • Glossários: um glossário é um dicionário personalizado que cria para traduzir termos específicos do domínio de forma correta e consistente.

  • Pedidos em lote: os pedidos em lote permitem-lhe fazer pedidos assíncronos que traduzem grandes quantidades de texto.

  • Tradução de documentos: esta funcionalidade permite-lhe traduzir documentos, como ficheiros PDF, preservando o formato e o esquema originais.

  • Funções do IAM: as funções do IAM permitem-lhe proteger os seus pedidos de tradução através da gestão de identidade e de acesso. Pode criar contas de serviço e conceder-lhes autorizações através de funções do IAM. Tenha em atenção que a API Cloud Translation – Advanced não suporta chaves de API.

  • Etiquetas: pode adicionar etiquetas definidas pelo utilizador (pares de chave/valor) aos seus pedidos de tradução para acompanhar a utilização e ativar relatórios de faturação detalhados.

  • Ponto final regional: ao usar um ponto final regional, pode exercer controlo sobre onde os recursos do seu projeto são armazenados e processados.

Funcionalidades avançadas da API

A utilização da API Cloud Translation – Advanced em vez da API Cloud Translation – Basic dá-lhe acesso às seguintes funcionalidades que podem tornar a sua solução de tradução mais robusta e mais adequada ao seu exemplo de utilização específico:

Seleção e personalização de modelos

A seleção de modelos da API Cloud Translation – Advanced permite-lhe selecionar dinamicamente diferentes modelos, incluindo modelos que personaliza para se adequarem à sua aplicação específica.

Glossários

Um glossário é um dicionário personalizado que a Cloud Translation - Advanced API usa para traduzir corretamente e de forma consistente termos específicos do domínio, entidades com nomes e outros tipos de termos que são específicos para si. Por exemplo, pode usar um glossário para especificar uma tradução específica para termos como "Google Summer of Code", "modo confidencial do Gmail" ou "relatório de desempenho do posicionamento".

Também pode usar glossários para impedir a tradução de determinadas palavras, como palavras emprestadas ou nomes de produtos. Para ver informações sobre como usar glossários, consulte o artigo Criar e usar glossários.

Pedidos em lote

Os pedidos de tradução em lote são pedidos assíncronos que traduzem a entrada de contentores do Cloud Storage. A API Cloud Translation - Advanced executa a tradução em lote como uma operação de longa duração e escreve o resultado num contentor do Cloud Storage que especificar. Os pedidos inline de tradução em lote não são suportados.

Tradução de documentos

A tradução de documentos permite-lhe traduzir diretamente documentos existentes, como ficheiros PDF e DOCX, para um idioma de destino. A tradução de documentos preserva o formato original para que os documentos traduzidos tenham o mesmo esquema e formato que os documentos originais. Por exemplo, a tradução de documentos mantém as quebras de parágrafos e os cabeçalhos para que o conteúdo traduzido seja dividido da mesma forma que no documento original.

As funcionalidades da API Cloud Translation - Advanced, como glossários e modelos NMT personalizados, também funcionam com a Tradução de documentos. Por exemplo, se já tiver um modelo de NMT personalizado que usa para traduções de texto, pode usar esse mesmo modelo para a tradução de documentos. Para mais informações sobre os tipos de ficheiros suportados e como traduzir documentos, consulte o artigo Traduza documentos.

Funções de IAM

A API Cloud Translation - Advanced integra-se com a IAM para oferecer segurança adicional para os seus pedidos de tradução, permitir o controlo de acesso detalhado e suportar a integração com modelos NMT personalizados.

Tem de adicionar utilizadores e contas de serviço a uma das seguintes funções para conceder a essas contas acesso à API Cloud Translation - Advanced. Para obter informações sobre a criação de contas de serviço, consulte o artigo Criar e gerir contas de serviço na documentação da IAM.

Função ID da função Descrição
Visualizador da API Cloud Translation roles/cloudtranslate.viewer Pode aceder às operações de obtenção e listagem.
Utilizador da Cloud Translation API roles/cloudtranslate.user

Inclui as autorizações de roles/cloudtranslate.viewer. Pode traduzir texto através do modelo de NMT da Google e de modelos de NMT personalizados no modo online e assíncrono (em lote). Pode usar a tradução de documentos. Pode detetar o idioma. Pode listar os idiomas suportados para modelos de NMT. Pode usar glossários para tradução.
Editor da Cloud Translation API roles/cloudtranslate.editor

Inclui as autorizações de roles/cloudtranslate.user e pode criar e eliminar glossários, bem como cancelar ou eliminar operações de longa duração.
Administrador da API Cloud Translation roles/cloudtranslate.admin

Inclui as autorizações de roles/cloudtranslate.editor, e pode definir políticas IAM e conceder autorizações IAM para a API Cloud Translation. Tem todas as autorizações de IAM para a Cloud Translation API.

Para ver uma lista das autorizações contidas em cada função, consulte o artigo Compreender as funções.

Estas funções pré-configuradas abordam muitos exemplos de utilização típicos. No entanto, pode precisar de uma função que inclua um conjunto personalizado de autorizações. Por exemplo, pode querer criar uma função que permita a um utilizador criar um glossário num projeto, sem lhe permitir eliminar ou atualizar glossários existentes no projeto. Nesses casos, pode criar uma função personalizada do IAM que satisfaça as suas necessidades.

Para obter informações sobre a gestão de funções de IAM, consulte os artigos Conceder, alterar e revogar o acesso a recursos e Conceder funções a contas de serviço.

Etiquetas

A API Cloud Translation - Advanced 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 custos de faturação filtrando as suas etiquetas.

Para mais informações acerca das etiquetas definidas pelo utilizador, consulte o artigo Relatórios de utilização com etiquetas (avançado).

Ponto final regional

Por predefinição, a API Cloud Translation – Advanced armazena e processa recursos numa localização global, o que significa que não existe garantia de que os recursos permaneçam numa localização específica. Em vez de usar o ponto final global predefinido, pode usar um ponto final regional para manter os recursos numa localização específica, como a União Europeia. Para mais informações, consulte o artigo Especifique um ponto final regional.

Comparação de edições

A tabela seguinte mostra as funcionalidades disponíveis em cada edição.

Funcionalidade Básico Avançado
Traduza com o modelo NMT
Traduza com o LLM de tradução
Traduza com modelos de tradução adaptativa
Traduza com modelos personalizados
Traduza várias strings num único pedido
Traduções em lote com o Cloud Storage
Traduza documentos
Suporte do glossário (terminologia de controlo)
Prepare modelos personalizados
Deteção de idioma
API REST integrada
API gRPC integrada
Conta de serviço
Chave de API
Registo de auditoria
Suporta HTML
Suporta mais de 100 idiomas
Suporte de romanização
Suporte de transliteração
Tradução adaptável
Suporte de pontos finais multirregionais
Suporte dos VPC Service Controls

Consulte o artigo Cloud Translation – Funcionalidades da API Advanced para mais detalhes sobre a API Cloud Translation – Advanced.

Preços

A Cloud Translation API cobra-lhe mensalmente com base no número de carateres que envia. Para mais informações, consulte a secção Preços.

Recursos e outras leituras