Neste documento, você verá como usar a API Cloud Translation (v2) para listar os idiomas compatíveis.
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 ver mais informações, consulte a página Configuração.
Lista de idiomas compatíveis
REST
Para uma lista de todos os idiomas compatíveis, faça uma solicitação GET
para o
endpoint https://translation.googleapis.com/language/translate/v2/languages
.
Veja a seguir o exemplo de uma solicitação GET
usando curl
e PowerShell.
O exemplo usa o token de acesso de uma conta de serviço configurada para o projeto por meio da Google Cloud CLI. Consulte
a página Configuração para ver instruções de como instalar a CLI,
configurar um projeto com uma conta de serviço e conseguir um token
de acesso.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_NUMBER_OR_ID
: o ID numérico ou alfanumérico do projeto do Google Cloud
Método HTTP e URL:
GET https://translation.googleapis.com/language/translate/v2/languages
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "languages": [ { "language": "en" }, { "language": "fr" }, { "language": "zh-CN" } ] }
Esta consulta retorna códigos ISO 639-1 para idiomas compatíveis. Alguns códigos de idioma também incluem o código do país, como zh-CN ou zh-TW. A lista é classificada em ordem alfabética por código de idioma. O exemplo acima foi encurtado por causa das restrições de espaço.
Go
Java
Node.js
Python
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 do 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 do 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 do Cloud Translation para Ruby.
Listar idiomas compatíveis com o nome do idioma de chegada
REST
Veja outro exemplo que retorna a lista de idiomas compatíveis. Os nomes de idiomas retornados são escritos em um idioma de chegada especificado. A lista retornada é organizada em ordem alfabética de acordo com esse idioma.
Para listar os idiomas compatíveis em um idioma de destino, faça uma solicitação POST
e forneça um JSON que identifique o idioma de destino no corpo da solicitação. Veja a seguir um exemplo de uma solicitação POST
usando curl
ou PowerShell.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_NUMBER_OR_ID
: o ID numérico ou alfanumérico do projeto do Google Cloud
Método HTTP e URL:
POST https://translation.googleapis.com/language/translate/v2/languages
Corpo JSON da solicitação:
{ "target": "zh-TW" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "data": { "languages": [ { "language": "zh-CN", "name": "中文(簡體)" }, { "language": "fr", "name": "法文" }, { "language": "en", "name": "英文" } ] } }
Nesse caso, a consulta retorna os mesmos códigos de idioma acima, junto com name
que dão os nomes dos idiomas escritos no idioma de destino, zh-TW. O exemplo acima foi encurtado por causa das restrições de espaço.
Go
Java
Node.js
Python
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 do 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 do 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 do Cloud Translation para Ruby.
Recursos adicionais
- Para receber ajuda sobre como resolver erros ou problemas comuns, consulte a página Solução de problemas.