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 em que ela esteja ativada e as credenciais apropriadas. Você também pode instalar bibliotecas de cliente para linguagens de programação comuns para ajudá-lo 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 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 um exemplo de uma solicitação POST
usando curl
ou PowerShell. O exemplo utiliza o token de acesso para uma conta
de serviço configurada para o projeto com o
SDK do Cloud. Consulte a página Configuração
para ver instruções de como instalar o SDK do Cloud, configurar um projeto com uma conta de serviço
e conseguir um token de acesso.
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, 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/language/translate/v2/detect
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/language/translate/v2/detect " | Select-Object -Expand Content
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.
C#
Antes de testar esta amostra, siga as instruções de configuração para C# 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 C#.
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.
PHP
Antes de testar esta amostra, siga as instruções de configuração para PHP 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 PHP.
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.
Ruby
Antes de testar esta amostra, siga as instruções de configuração para Ruby 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 Ruby.
Como detectar o idioma de mais de uma string
REST e linha de comando
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:
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, 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/language/translate/v2/detect
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/language/translate/v2/detect " | Select-Object -Expand Content
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.
C#
Para detectar o idioma de vários textos, basta transmitir uma lista de strings para o método client.DetectLanguage
mostrado no exemplo anterior.
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.
Ruby
Para detectar o idioma de vários textos, basta transmitir várias strings para o método Translate#detect
mostrado no exemplo anterior.