Neste documento, você vê como usar o Cloud Translation – Advanced para detectar o idioma de uma string.
Antes de começar
Antes de começar a usar a API Cloud Translation, é preciso ter um projeto que tenha a API Cloud Translation ativada e uma chave privada com 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.
Como detectar o idioma de uma string de texto
Detecte o idioma de uma string de texto enviando uma solicitação HTTP usando um URL no seguinte formato:
https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global:detectLanguage
Como detectar o idioma de uma única string
REST e LINHA DE CMD
Para detectar o idioma de um texto, faça uma solicitação POST
e forneça
o corpo apropriado. Veja a seguir o exemplo de uma solicitação POST
usando curl
e PowerShell. O exemplo usa o token de acesso de uma conta de serviço configurada para o projeto por meio da CLI do Google Cloud.
Consulte a página Configuração
para ver instruções de como instalar a CLI do Google Cloud, 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: pelo número ou código do seu projeto do Google Cloud
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global:detectLanguage
Corpo JSON da solicitação:
{ "content":"Доктор Ватсон, иди сюда!" }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo chamado request.json
e execute o comando a seguir:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global:detectLanguage"
PowerShell
Salve o corpo da solicitação em um arquivo chamado request.json
e execute o comando a seguir:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
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/locations/global:detectLanguage" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "languages": [ { "languageCode": "ru", "confidence": 1 } ] }
languageCode
informa o código do idioma detectado. confidence
é um intervalo de 0 a 1, sendo que 1 indica confiança total.Go
Antes de testar esta amostra, siga as instruções de configuração para Go no Guia de início rápido do Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Translation para Go.
Java
Antes de testar esta amostra, siga as instruções de configuração para Java no Guia de início rápido do Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Translation para Java.
Node.js
Antes de testar esta amostra, siga as instruções de configuração para Node.js no Guia de início rápido do Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Translation para Node.js.
Python
Antes de testar esta amostra, siga as instruções de configuração para Python no Guia de início rápido do Translation: como usar bibliotecas de cliente. Saiba mais na documentação de referência da API Translation para 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 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 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 Translation para Ruby.
Outros recursos
- Para receber ajuda sobre como resolver erros ou problemas comuns, consulte a página Solução de problemas.