Neste documento, você vê como usar a Cloud Translation – Basic (v2) 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 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.
Como detectar o idioma de uma string de texto
Para detectar o idioma de uma string de texto, envie uma solicitação HTTP usando um URL no seguinte formato:
https://translation.googleapis.com/language/translate/v2/detect
Como detectar o idioma de uma única string
REST
Para detectar o idioma de um texto, faça uma solicitação POST
e forneça
o corpo apropriado. Veja a seguir um exemplo de uma solicitação POST
usando curl
ou PowerShell. O exemplo usa o token de acesso de uma conta de serviço configurada para o projeto por meio da Google Cloud CLI. Para instruções sobre como instalar a CLI do Google Cloud, configurar um projeto com uma conta de serviço e receber um token de acesso, consulte a página Configuração.
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/detect
Corpo JSON da solicitação:
{ "q": "Mi comida favorita es una enchilada." }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "data": { "detections": [ [ { "confidence": 1, "isReliable": false, "language": "es" } ] ] } }
Na resposta, language
é o código do idioma detectado. Os outros dois campos, isReliable
e confidence
, estão obsoletos e foram incluídos para fornecer compatibilidade com versões anteriores. Não recomendamos tomar decisões ou estabelecer limites com base nos valores deles.
Go
Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Go.
Para autenticar no 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 esta amostra, siga as instruções de configuração do Java no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Java.
Para autenticar no 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 esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Node.js.
Para autenticar no 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 esta amostra, siga as instruções de configuração do Python no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Python.
Para autenticar no 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 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.
Como detectar o idioma de mais de uma string
REST
Para detectar o idioma de mais de uma string, use o parâmetro q
para especificar cada string. Neste exemplo, duas strings separadas são transmitidas para detecção:
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/detect
Corpo JSON da solicitação:
{ "q": ["Hello world", "我的名字叫傑夫"] }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "data": { "detections": [ [ { "confidence": 1, "isReliable": false, "language": "en" } ], [ { "confidence": 1, "isReliable": false, "language": "zh-TW" } ] ] } }
A resposta contém duas detecções, na mesma ordem em que as strings de origem correspondentes foram fornecidas na solicitação.
Go
Para detectar o idioma de vários textos, inclua várias strings na fração transmitida para o método Client#DetectLanguage
mostrado no exemplo anterior.
Java
Para detectar o idioma de vários textos, basta transmitir uma lista de strings para o método Translate#detect
mostrado no exemplo anterior.
Node.js
Para detectar o idioma de vários textos, basta transmitir uma matriz de strings para o método Translate#detect
mostrado no exemplo anterior.
Python
Para detectar o idioma de vários textos, basta transmitir uma lista de strings para o método Client#detect_language
mostrado no exemplo anterior.
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.
Ruby
Para detectar o idioma de vários textos, basta transmitir várias strings para o método Translate#detect
mostrado no exemplo anterior.
Outros recursos
- Para receber ajuda sobre como resolver erros ou problemas comuns, consulte a página Solução de problemas.