En este documento, se describe cómo usar Cloud Translation básico (v2) para detectar el idioma de una string.
Antes de comenzar
Antes de comenzar a usar la API de Cloud Translation, debes tener un proyecto que tenga habilitada esta API y una clave privada con las credenciales adecuadas. También puedes instalar bibliotecas cliente para los lenguajes de programación comunes que te ayudarán a realizar llamadas a la API. Para obtener más información, consulta la página Configuración.
Detecta el idioma de una string de texto
Puedes detectar el idioma de una string de texto mediante el envío de una solicitud HTTP con una URL del siguiente formato:
https://translation.googleapis.com/language/translate/v2/detect
Cómo detectar el idioma de una sola string
LÍNEA DE REST Y CMD
Para detectar el idioma de un texto, realiza una solicitud POST
y proporciona el cuerpo de la solicitud correspondiente. A continuación, se muestra un ejemplo de una solicitud POST
mediante curl
o PowerShell. En el ejemplo, se usa el token de acceso correspondiente a la configuración de una cuenta de servicio para el proyecto con Google Cloud CLI. Si deseas obtener instrucciones para instalar Google Cloud CLI, configurar un proyecto con una cuenta de servicio y conseguir un token de acceso, consulta la página Configuración.
Método HTTP y URL:
POST https://translation.googleapis.com/language/translate/v2/detect
Cuerpo JSON de la solicitud:
{ "q": "Mi comida favorita es una enchilada." }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "data": { "detections": [ [ { "confidence": 1, "isReliable": false, "language": "es" } ] ] } }
En la respuesta, language
es el código de idioma detectado. Los otros dos campos, isReliable
y confidence
, son campos obsoletos que se incluyen para permitir la compatibilidad con versiones anteriores. Recomendamos no tomar decisiones ni definir los umbrales en función de sus valores.
Comienza a usarlo
Antes de probar este ejemplo, sigue las instrucciones de configuración de Go que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Go.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Java.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Node.js.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Python.
Lenguajes adicionales
C#: Sigue las Instrucciones de configuración de C# en la página de bibliotecas cliente y, luego, visita la Documentación de referencia de Translation para .NET.
PHP: Sigue las Instrucciones de configuración de PHP en la página de bibliotecas cliente y, luego, visita la Documentación de referencia de Translation para PHP.
Ruby: Sigue las Instrucciones de configuración de Ruby en la página de bibliotecas cliente y, luego, visita la Documentación de referencia de Translation para Ruby.
Detecta el idioma de más de una string
LÍNEA DE REST Y CMD
Para detectar el idioma de más de una string, usa el parámetro q
a fin de especificar cada string. En este ejemplo, se pasan dos strings distintas para la detección:
Método HTTP y URL:
POST https://translation.googleapis.com/language/translate/v2/detect
Cuerpo JSON de la solicitud:
{ "q": ["Hello world", "我的名字叫傑夫"] }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "data": { "detections": [ [ { "confidence": 1, "isReliable": false, "language": "en" } ], [ { "confidence": 1, "isReliable": false, "language": "zh-TW" } ] ] } }
Aquí, la respuesta contiene dos detecciones, en el mismo orden en que se proporcionaron las strings fuente correspondientes en la solicitud.
Comienza a usarlo
Para detectar el idioma de varios textos, debes incluir varias strings en la parte que pasaste al método Client#DetectLanguage
que se muestra en el ejemplo anterior.
Java
Para detectar el idioma de varios textos, solo debes pasar una lista de strings al método Translate#detect
que se muestra en el ejemplo anterior.
Node.js
Para detectar el idioma de varios textos, solo debes pasar un arreglo de strings al método Translate#detect
que se muestra en el ejemplo anterior.
Python
Para detectar el idioma de varios textos, solo debes pasar una lista de strings al método Client#detect_language
que se muestra en el ejemplo anterior.
Lenguajes adicionales
C#: Sigue las Instrucciones de configuración de C# en la página de bibliotecas cliente y, luego, visita la Documentación de referencia de Translation para .NET.
PHP: Sigue las Instrucciones de configuración de PHP en la página de bibliotecas cliente y, luego, visita la Documentación de referencia de Translation para PHP.
Ruby: Sigue las Instrucciones de configuración de Ruby en la página de bibliotecas cliente y, luego, visita la Documentación de referencia de Translation para Ruby.
Ruby
Para detectar el idioma de varios textos, solo debes pasar varias strings al método Translate#detect
que se muestra en el ejemplo anterior.
Recursos adicionales
- Para obtener ayuda en la resolución de errores o problemas habituales, consulta la página Solución de problemas.