GSP049
Descripción general
La API de Cloud Translation usa la tecnología de traducción automática neuronal de Google para traducir textos de manera instantánea a más de cien idiomas.
En este lab, usarás la API para traducir un texto y detectar el idioma que se usa en él.
Qué aprenderás
En este lab, usarás la API de Cloud Translation para hacer lo siguiente:
- Crear una solicitud a la API de Cloud Translation y llamarla con
curl
- Traducir texto
- Usar la edición Premium
- Detectar idiomas
Configuración y requisitos
Antes de hacer clic en el botón Comenzar lab
Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.
Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.
Para completar este lab, necesitarás lo siguiente:
- Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.
Nota: Usa una ventana del navegador privada o de incógnito (opción recomendada) para ejecutar el lab. Así evitarás conflictos entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.
- Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).
Nota: Usa solo la cuenta de estudiante para este lab. Si usas otra cuenta de Google Cloud, es posible que se apliquen cargos a esa cuenta.
Cómo iniciar tu lab y acceder a la consola de Google Cloud
-
Haz clic en el botón Comenzar lab. Si debes pagar por el lab, se abrirá un diálogo para que selecciones la forma de pago.
A la derecha, se encuentra el panel Configuración del lab y acceso, que tiene los siguientes elementos:
- El botón Abrir la consola de Google Cloud
- Las credenciales temporales (nombre de usuario y contraseña) que debes usar para este lab
- Otra información para completar el lab (si es necesaria)
Ten en cuenta que el cronómetro del lab se encuentra cerca de la parte superior de la página y muestra el tiempo restante.
-
Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).
El lab inicia los recursos y abre otra pestaña, en la que se muestra la página de acceso.
Sugerencia: Ordena las pestañas en ventanas separadas, una junto a la otra.
Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usa otra cuenta.
-
De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.
{{{user_0.username | "Username"}}}
También puedes encontrar el nombre de usuario en el panel Configuración del lab y acceso.
-
Haz clic en Siguiente.
-
Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.
{{{user_0.password | "Password"}}}
También puedes encontrar la contraseña en el panel Configuración del lab y acceso.
-
Haz clic en Siguiente.
Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud.
Nota: Usar tu propia cuenta de Google Cloud para este lab podría generar cargos adicionales.
-
Haz clic para avanzar por las páginas siguientes:
- Acepta los Términos y Condiciones.
- No agregues opciones de recuperación ni autenticación de dos factores, ya que esta cuenta es temporal.
- No te registres para obtener pruebas gratuitas.
Después de un momento, se abrirá la consola de Google Cloud en esta pestaña.
Nota: Para acceder a los productos y servicios de Google Cloud, haz clic en el menú de navegación o escribe el nombre del servicio o producto en el campo Buscar.
Activa Cloud Shell
Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.
-
Haz clic en Activar Cloud Shell
en la parte superior de la consola de Google Cloud.
-
Haz clic para avanzar por las siguientes ventanas:
- Continúa en la ventana de información de Cloud Shell.
- Autoriza a Cloud Shell para que use tus credenciales para realizar llamadas a la API de Google Cloud.
Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu Project_ID, . El resultado contiene una línea que declara el Project_ID para esta sesión:
Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}
gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.
- Puedes solicitar el nombre de la cuenta activa con este comando (opcional):
gcloud auth list
- Haz clic en Autorizar.
Resultado:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- Puedes solicitar el ID del proyecto con este comando (opcional):
gcloud config list project
Resultado:
[core]
project = {{{project_0.project_id | "PROJECT_ID"}}}
Nota: Para obtener toda la documentación de gcloud, en Google Cloud, consulta la guía con la descripción general de gcloud CLI.
Establece la región para tu proyecto
Ejecuta el siguiente comando para establecer la región de tu proyecto:
export REGION={{{project_0.default_region | REGION}}}
gcloud config set compute/region $REGION
Tarea 1: Crea una clave de API
Como más adelante en este lab usarás curl para enviar una solicitud a la API de Translation, deberás generar una clave de API para incluirla en la URL de la solicitud.
-
Para crear una clave de API, en el menú de navegación (
), haz clic en APIs y servicios > Credenciales.
-
Haz clic en + Crear credenciales y selecciona Clave de API.
-
En el panel lateral Crear clave de API que aparece, en APIs a las que se puede acceder con esta clave, haz clic en el menú desplegable Elige las restricciones de API.
-
Busca API de Cloud Translation o desplázate hasta encontrarla y, luego, marca la casilla.
-
Haz clic en Aceptar.
-
Haz clic en Crear.
-
Copia la clave de API que se generó y haz clic en Cerrar.
Ahora, guárdala en una variable de entorno para no tener que ingresar el valor de la clave de API en cada solicitud.
- En Cloud Shell, ejecuta lo siguiente: Asegúrate de reemplazar
[YOUR_API_KEY] por la clave que acabas de copiar:
export API_KEY=[YOUR_API_KEY]
Haz clic en Revisar mi progreso para verificar el objetivo.
Crear una clave de API
Tarea 2: Traduce texto
En este ejemplo, traducirás la cadena "My name is Steve" al español.
- Pasa el texto que se traducirá, junto con la variable de entorno de la clave de API, a la API de Translation con el siguiente comando
curl:
TEXT="My%20name%20is%20Steve"
curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"
La respuesta debería verse de la siguiente manera:
{
"data": {
"translations": [
{
"translatedText": "Mi nombre es Steve",
"detectedSourceLanguage": "en"
}
]
}
}
En la respuesta, puedes ver el texto traducido y el idioma de origen que detectó la API.
Nota: Modo Premium
La API de Google Cloud Translation de Google usa un modelo de edición estándar para la mayoría de las tareas de traducción. Google mejoró su servicio de traducción para usar un sistema de traducción automática neuronal más sólido. Si quieres obtener más información sobre el uso de este modelo premium, consulta la documentación de Cloud Translation.
Tarea 3: Detecta el idioma
Además de traducir texto, la API de Translation puede detectar el idioma del texto. En este ejemplo, detecta el idioma de dos cadenas.
- Pasa el texto que se examinará, junto con la variable de entorno de la clave de API, a la API de Translation con el siguiente comando curl:
TEXT_ONE="Meu%20nome%20é%20Steven"
TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります"
curl -X POST "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}" -d "q=${TEXT_ONE}" -d "q=${TEXT_TWO}"
La respuesta debería verse de la siguiente manera:
{
"data": {
"detections": [
[
{
"isReliable": false,
"language": "pt",
"confidence": 1
}
],
[
{
"language": "ja",
"isReliable": false,
"confidence": 1
}
]
]
}
}
Los idiomas que devuelve esta muestra son "pt" y "ja". Esos son los identificadores ISO-639-1 para portugués y japonés. En esta lista de idiomas compatibles con la API de Translation, se enumeran todos los códigos de idioma posibles que se pueden devolver.
¡Felicitaciones!
Aprendiste a traducir texto con la API de Cloud Translation.
Realiza tu próximo lab
Próximos pasos y más información
Capacitación y certificación de Google Cloud
Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.
Última actualización del manual: 8 de abril de 2026
Prueba más reciente del lab: 8 de abril de 2026
Copyright 2026 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.