Traduzir textos com a Cloud Translation Advanced
Neste documento, mostramos como traduzir um texto de exemplo usando a Cloud Translation Advanced.
Antes de começar
Antes de começar a usar a API Cloud Translation, é preciso ter um projeto com a API Cloud Translation ativada e as credenciais apropriadas. Também é possível instalar bibliotecas de cliente para linguagens de programação comuns para ajudar você a fazer chamadas para a API. Para mais informações, consulte a página Configuração.
Exemplo de texto traduzido
Confira no exemplo a seguir como usar a Cloud Translation – Advanced para traduzir textos para um determinado idioma de destino.
REST
Use o curl ou o PowerShell para fazer uma solicitação.
Use os códigos ISO-639 para identificar os idiomas de origem e de destino. No exemplo, o idioma de origem é o inglês (en) e o de chegada é o russo (ru). O formato da consulta é referido como “text” em texto simples.
Antes de usar os dados da solicitação, substitua estes dados:
- PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do seu projeto do Google Cloud
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corpo JSON da solicitação:
{
"sourceLanguageCode": "en",
"targetLanguageCode": "ru",
"contents": ["Dr. Watson, come here!"],
"mimeType": "text/plain"
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"translations": [{
"translatedText": "Доктор Ватсон, иди сюда!"
}]
}
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido da Cloud Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Cloud Translation para Go.
Para autenticar-se na Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido da Cloud Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Cloud Translation para Java.
Para autenticar-se na Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido da Cloud Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Cloud Translation para Node.js.
Para autenticar-se na Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido da Cloud Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Cloud Translation para Python.
Para autenticar-se na Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Outras linguagens
C#: Siga as Instruções de configuração do C# na página das bibliotecas de cliente e acesse Documentação de referência da Cloud Translation para o .NET.
PHP: Siga as Instruções de configuração do PHP na página das bibliotecas de cliente e acesse Documentação de referência da Cloud Translation para PHP.
Ruby: Siga as Instruções de configuração do Ruby na página das bibliotecas de cliente e acesse Documentação de referência da Cloud Translation para Ruby.
Outros recursos
- Para mais informações sobre tradução de textos, consulte o guia de instruções Como traduzir textos (Advanced).
- Para receber ajuda sobre como resolver erros ou problemas comuns, consulte a página Solução de problemas.
- Para respostas a perguntas gerais sobre a Cloud Translation, consulte a página Perguntas frequentes gerais.
- Observação: a Cloud Translation está disponível em duas edições. Para mais informações sobre cada edição, consulte Como comparar a edição Basic e a Advanced.