GSP277

Descripción general

El Explorador de APIs de Google es una herramienta que te permite explorar diversos métodos de la API de Google sin escribir código. Con el Explorador de APIs, puedes hacer lo siguiente:

• Explorar rápidamente las APIs y versiones disponibles
• Ver los métodos disponibles para cada API y los parámetros que admiten, junto con la documentación intercalada
• Ejecutar solicitudes para cualquier método y ver las respuestas en tiempo real
• Hacer llamadas autenticadas y autorizadas a la API
• Buscar en todos los servicios, los métodos y tus solicitudes recientes para encontrar al instante lo que estás buscando

El Explorador de APIs utiliza sus propias claves de API cada vez que realiza una solicitud. Cuando se utiliza el Explorador de APIs para realizar una solicitud, se muestra la sintaxis de esta, que incluye un marcador de posición con la etiqueta {YOUR_API_KEY}. Si deseas realizar la misma solicitud en tu aplicación, debes reemplazar este marcador de posición por tu propia clave de API.

Objetivos

• Crear un bucket de Cloud Storage
• Subir una imagen a Cloud Storage y hacerla pública
• Realizar una solicitud a la API de Vision con dicha imagen

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs son cronometrados y no se pueden pausar. El cronómetro, 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 de navegador privada o de Incógnito para ejecutar este lab. Así evitarás cualquier conflicto 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: Si ya tienes un proyecto o una cuenta personal de Google Cloud, no los uses en este lab para evitar cargos adicionales en tu cuenta.

Cómo iniciar tu lab y acceder a la consola de Google Cloud

1. Haga clic en el botón Comenzar lab. Si debe pagar por el lab, se abrirá una ventana emergente para que seleccione su forma de pago. A la izquierda, se encuentra el panel Detalles del lab, que tiene estos elementos:

   • El botón Abrir la consola de Google Cloud
   • El tiempo restante
   • Las credenciales temporales que debe usar para el lab
   • Otra información para completar el lab, si es necesaria

2. 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 recursos y abre otra pestaña en la que se muestra la página de acceso.

   Sugerencia: Ordene las pestañas en ventanas separadas, una junto a la otra.

   Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usar otra cuenta.

3. 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 Detalles del lab.

4. Haz clic en Siguiente.

5. 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 Detalles del lab.

6. 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 podría generar cargos adicionales.

7. Haga clic para avanzar por las páginas siguientes:

   • Acepta los Términos y Condiciones.
   • No agregues opciones de recuperación o autenticación de dos factores (esta es una cuenta 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 ver un menú con una lista de productos y servicios de Google Cloud, haz clic en el menú de navegación que se encuentra en la parte superior izquierda.

Tarea 1: Crea un bucket de Cloud Storage

1. En la consola de Cloud, ve a Cloud Storage > Buckets.
2. Haz clic en Crear bucket.
3. Establece un nombre único para el bucket. No incluyas información sensible en el nombre del bucket, ya que el espacio de nombres del bucket es global y tiene visibilidad pública. Por ejemplo, -bucket.
4. Haz clic en Elige cómo controlar el acceso a los objetos.
5. Desmarca la opción Aplicar la prevención de acceso público a este bucket.
6. Selecciona el control de acceso detallado.
7. Haz clic en Crear.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si creaste con éxito un bucket de Cloud Storage, verás una puntuación de evaluación.

Crear un bucket de Cloud Storage

Tarea 2. Sube una imagen

Se le pedirá a la API de Cloud Vision que analice una imagen con el Explorador de API. Primero, agrega una imagen a tu bucket para analizarla. Puedes usar una imagen propia o descargar la siguiente imagen en tu computadora y guardarla como demo-image.jpg.

1. En tu bucket, haz clic en Subir archivos y selecciona el archivo demo-image.jpg que guardaste.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si subiste una imagen a un bucket de almacenamiento de forma correcta, verás una puntuación de evaluación.

Subir una imagen a un bucket de almacenamiento (“demo-image.jpg”)

Una vez que hayas subido el archivo a tu bucket, realiza los siguientes pasos para compartir la imagen públicamente:

1. Haz clic en el menú ampliado de los tres puntos verticales asociado a tu imagen.
2. Selecciona Editar acceso en el menú desplegable.
3. En la superposición que aparece, haz clic en el botón + Agregar entrada.
4. Para allUsers, agrega un permiso.
   • En Entidad, selecciona Pública.
   • En Nombre, ingresa allUsers.
   • En Acceso, selecciona Lector.
5. Haz clic en Guardar.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si pudiste hacer que la imagen subida sea públicamente accesible, verás una puntuación de evaluación.

Permitir que se pueda acceder públicamente a la imagen que subiste

Ahora deberías ver que la imagen es pública. Ya tienes todo listo para utilizar el Explorador de APIs.

Tarea 3. Realiza una solicitud al servicio de la API de Cloud Vision

1. Ve al menú de navegación > APIs y servicios.

2. Haz clic en + HABILITAR LAS APIS Y LOS SERVICIOS, busca Cloud Vision y, luego, selecciona laAPI de Cloud Vision de la lista de resultados y haz clic en ella.

3. Asegúrate de que la API esté habilitada; si no lo está, haz clic en Habilitar.

4. Abre el vínculo Cloud Vision - Probar esta API.

Se abrirá una nueva pestaña con la página del Explorador de APIs cargada.

Ahora deberías estar en la página del Explorador de APIs.

Nota: En la sección que aparece a continuación, se utiliza el método images.annotate de la API de Cloud Vision. Puedes ver todas las versiones de la API y su método en la referencia de la API de Cloud Vision.

5. En el campo Cuerpo de la solicitud, haz clic dentro de las llaves.
6. Cuando se te pida que selecciones una propiedad, elige “Solicitudes”. Esto generará el siguiente nivel.
7. Haz clic dentro de los corchetes y en el ícono azul de signo más; luego, selecciona [Add Item]. Para la propiedad, selecciona “atributos”.
8. En “atributos”, haz clic dentro de la llave y en el ícono de signo más de color azul y, luego, selecciona [Add Item]; selecciona “tipo” y, a su lado, selecciona LABEL_DETECTION.
9. Debería aparecer el ícono de signo más de color azul al final del bloque “atributos”, donde puedes agregar una “imagen”; luego, agrega “fuente” y después “imageUri”.
10. Junto a “imageUri”, ingresa la ruta de acceso al archivo de imagen en tu bucket. La ruta de acceso se verá de la siguiente manera: gs://MY_BUCKET/demo-image.jpg

Cuando finalices, el cuerpo de la solicitud se verá de la siguiente manera:

11. En la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

Nota: Para ver las Preguntas frecuentes sobre las credenciales, haz clic en el ícono de signo de interrogación que aparece junto al título Credenciales.

12. En el panel derecho de una consola del Explorador de APIs, puedes ver una llamada a la API de Cloud Vision con cURL, HTTP y JAVASCRIPT.

13. Ahora, haz clic en Ejecutar.

14. Selecciona tu cuenta de estudiante.

15. En la siguiente pantalla, haz clic en Permitir para conceder acceso al Explorador de APIs.

Los resultados del análisis de la imagen por parte de la API de Cloud Vision aparecerán abajo en el panel del lado derecho. La parte superior de los resultados se verá de la siguiente manera:

Tarea 4. Pon a prueba tus conocimientos

Responde estas preguntas de opción múltiple para reforzar tus conocimientos sobre los conceptos de este lab. Trata de responderlas lo mejor posible.

¡Felicitaciones!

Realizaste tu primera solicitud images.annotate al servicio de la API de Cloud Vision.

Finaliza la Quest

Este lab de autoaprendizaje forma parte de las Quests Exploring APIs e Intro to ML: Image Processing. Una Quest es una serie de labs relacionados que forman una ruta de aprendizaje. Si completas esta Quest, obtendrás una insignia como reconocimiento por tu logro. Puedes hacer públicas tus insignias y agregar vínculos a ellas en tu currículum en línea o en tus cuentas de redes sociales. Inscríbete en cualquier Quest que contenga este lab y obtén un crédito inmediato de finalización. Consulta el catálogo de Google Cloud Skills Boost para ver todas las Quests disponibles.

Realiza tu próximo lab

Este lab forma parte de una serie llamada Qwik Starts. Estos labs están diseñados para ofrecerte una visión general de las numerosas funciones disponibles en Google Cloud. Busca “Qwik Starts” en el catálogo de labs para elegir el siguiente lab en el que desees participar.

Próximos pasos y más información

• Aprende a usar el Explorador de APIs a través de la página de preguntas frecuentes acerca del Explorador de APIs.
• Obtén más información acerca de la API de Cloud Vision.

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.

Finaliza el lab

Cuando completes el lab, haz clic en Finalizar lab. Tu cuenta y los recursos que usaste se quitaron de la plataforma del lab.

Tendrás la oportunidad de calificar tu experiencia en el lab. Selecciona la cantidad de estrellas que corresponda, ingresa un comentario y haz clic en Enviar.

La cantidad de estrellas indica lo siguiente:

• 1 estrella = Muy insatisfecho
• 2 estrellas = Insatisfecho
• 3 estrellas = Neutral
• 4 estrellas = Satisfecho
• 5 estrellas = Muy satisfecho

Puedes cerrar el cuadro de diálogo si no deseas proporcionar comentarios.

Para enviar comentarios, sugerencias o correcciones, usa la pestaña Asistencia.

Actualización más reciente del manual: 19 de septiembre de 2023

Prueba más reciente del lab: 19 de septiembre de 2023

Copyright 2024 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.