GSP421

Descripción general

El Explorador de APIs de Google es una herramienta que te ayuda a explorar varias APIs de Google de manera interactiva. Con el Explorador de APIs, puedes hacer lo siguiente:

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

Cloud Storage permite almacenar y recuperar cualquier cantidad de datos en todo el mundo y en cualquier momento. Puedes usar Cloud Storage en diversas situaciones, como entregar contenido de un sitio web, almacenar datos para archivarlos y recuperarlos ante desastres, o distribuir grandes objetos de datos a los usuarios a través de una descarga directa.

En este lab, usarás el Explorador de APIs para hacer solicitudes a la API de Cloud Storage que crean y borran buckets de Cloud Storage. También aprenderás a copiar y borrar archivos en Cloud Storage.

Objetivos

En este lab, aprenderás a hacer lo siguiente:

• Crear buckets de Cloud Storage con el Explorador de APIs
• Subir archivos de imagen a tu bucket de Cloud Storage
• Copiar un archivo de imagen y agregarlo a un bucket de Cloud Storage mediante el Explorador de API
• Borrar archivos de imagen de tu bucket de Cloud Storage con el Explorador de APIs
• Borrar un bucket de Cloud Storage con el Explorador de APIs

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 buckets de Cloud Storage

1. Para acceder a la herramienta del Explorador de APIs de Cloud Storage, en el Menú de navegación selecciona APIs y servicios > Biblioteca.

2. En la barra de búsqueda, ingresa Cloud Storage.

3. En la lista de resultados, haz clic en la API de Google Cloud Storage JSON.

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

5. Abre Buckets: referencia de insert. 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 siguiente sección, usarás el método insert de la API de Cloud Storage JSON. Puedes ver todas las versiones de la API y su método en la referencia de la API.

6. Ahora, haz clic en el cuerpo de la solicitud en el panel derecho debajo de Probar esta API y completa los detalles de tu bucket de almacenamiento.

• project: agrega tu ID del proyecto - .
• Cuerpo de la solicitud: Haz clic dentro de las comillas junto al par clave-valor name y asigna un nombre único a tu bucket de Cloud Storage de acuerdo con los lineamientos para asignar nombres a buckets de Cloud Storage.

Tu método debería ser similar al siguiente:

Nota: Asegúrate de que no haya espacios finales en el campo del ID del proyecto. Además, 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 credenciales, haz clic en el ícono de signo de interrogación que aparece junto al título Credenciales.

7. Haz clic en el botón Ejecutar.

8. Selecciona la cuenta de estudiante con la que iniciaste el lab.

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

Tu respuesta debería verse de esta manera:

{ "kind": "storage#bucket", "id": "qwiklabs-bucket01", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket01", "projectNumber": "250399850182", "name": "qwiklabs-bucket01", "timeCreated": "2019-10-18T13:59:08.300Z", "updated": "2019-10-18T13:59:08.300Z", "metageneration": "1", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "location": "US", "locationType": "multi-region", "storageClass": "STANDARD", "etag": "CAE=" }

Haz clic en Revisar mi progreso para verificar el objetivo. Crear un bucket de Cloud Storage

Tarea 2. Haz un segundo bucket de Cloud Storage

Ahora, haz otro bucket de Cloud Storage para practicar cómo copiar archivos entre los dos buckets.

1. En el método insert, asegúrate de que el ID del proyecto siga en el campo del proyecto.

2. En el cuerpo de la solicitud, para el par clave-valor name, establece un nombre único en el segundo bucket.

3. Asegúrate de que no haya espacios finales en los campos.

4. Haz clic en el botón Ejecutar. Tu respuesta debería verse de esta manera:

{ "kind": "storage#bucket", "id": "qwiklabs-bucket02", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket02", "projectNumber": "250399850182", "name": "qwiklabs-bucket02", "timeCreated": "2019-10-18T13:59:08.300Z", "updated": "2019-10-18T13:59:08.300Z", "metageneration": "1", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "location": "US", "locationType": "multi-region", "storageClass": "STANDARD", "etag": "CAE=" }

Creaste correctamente dos buckets con el método insert. A continuación, los verás en la consola de Cloud.

Haz clic en Revisar mi progreso para verificar el objetivo. Hacer un segundo bucket de Cloud Storage.

Ve tus buckets de Cloud Storage en la consola de Cloud

1. Vuelve a la consola de Cloud y, en el menú de navegación, ve a Cloud Storage para asegurarte de que se crearon tus buckets de Cloud Storage.

2. En el menú de navegación, selecciona Cloud Storage > Buckets. Deberías ver agregados tus buckets recientemente creados.

Continúa en la consola de Cloud para el paso siguiente. Mantén abierta la pestaña del Explorador de APIs.

Tarea 3. Sube archivos a tu bucket de Cloud Storage

Sube algunos archivos a tu bucket de Cloud Storage para adquirir práctica con los métodos alojados en el Explorador de APIs.

1. Guarda la siguiente imagen en tu computadora y asígnale el nombre demo-image1.png:

2. Luego, guarda esta imagen de dominio público de Ada Lovelace en tu computadora y asígnale el nombre demo-image2.png:

3. En el navegador de Cloud Storage, selecciona el primer bucket de la lista.

4. Haz clic en Subir archivos, y selecciona demo-image1.png y demo-image2.png de tu computadora.

Tu bucket debería tener ambos archivos de imagen agregados y debería ser similar al siguiente:

Haz clic en Revisar mi progreso para verificar el objetivo. Subir archivos a tu bucket de Cloud Storage (demo-image1.png y demo-image2.png).

A continuación, copiarás uno de los archivos de imagen a tu segundo bucket de Cloud Storage.

Tarea 4. Copia archivos entre buckets de Cloud Storage

1. Desde la sección APIs y referencias ubicada a la izquierda, navega a API de JSON > Referencia de la API > Objetos > copy para usar el método de copy, o bien, para copiar buckets de almacenamiento con el Explorador de APIs, usa Objetos: referencia de copy.

2. Actualiza de la siguiente manera:

• sourceBucket: Escribe el nombre del bucket que contenga los archivos de imagen de demostración.
• sourceObject: Ingresa demo-image1.png.
• destinationBucket: Ingresa el nombre del segundo depósito (vacío).
• destinationObject: Escribe demo-image1-copy.png.

Tu método debería verse de esta manera:

3. 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 credenciales, haz clic en el ícono de signo de interrogación que aparece junto al título Credenciales.

4. Asegúrate de que no haya espacios finales en los campos.

5. Ahora desplázate hacia abajo y haz clic en Ejecutar.

Deberías obtener un resultado similar al siguiente:

{ "kind": "storage#object", "id": "qwiklabs-bucket02/demo-image1-copy.png/1571408245199237", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket02/o/demo-image1-copy.png", "name": "demo-image1-copy.png", "bucket": "qwiklabs-bucket02", "generation": "1571408245199237", "metageneration": "1", "contentType": "image/png", "timeCreated": "2019-10-18T14:17:25.198Z", "updated": "2019-10-18T14:17:25.198Z", "storageClass": "STANDARD", "timeStorageClassUpdated": "2019-10-18T14:17:25.198Z", "size": "401951", "md5Hash": "LbpHpwhnApQKQx9IEXjTsQ==", "mediaLink": "https://www.googleapis.com/download/storage/v1/b/qwiklabs-bucket02/o/demo-image1-copy.png?generation=1571408245199237&alt=media", "owner": { "entity": "user-gcpstaging93416_student@qwiklabs.net" }, "crc32c": "j5oPrg==", "etag": "CIWjgvL/peUCEAE=" }

Copiaste correctamente un archivo de un bucket a otro con el método objects.copy.

Haz clic en Revisar mi progreso para verificar el objetivo. Copiar archivos entre los buckets de Cloud Storage (demo-image1-copy.png).

Visualiza tu bucket actualizado en la consola de Cloud

1. Para este paso, regresa a la consola de Cloud. Deberías haberte detenido en la página de detalles de tu bucket de Cloud Storage.

2. En el menú de la izquierda, haz clic en Buckets y selecciona tu segundo bucket. Deberías ver la copia agregada de demo-image1.png.

Tarea 5. Borra archivos de un bucket de Cloud Storage

1. Desde la sección APIs y referencias, navega a API de JSON > Referencia de la API > Objetos > delete, o bien, para borrar archivos de un bucket de Cloud Storage con el Explorador de APIs, usa Objetos: referencia de delete.

2. Ahora borrarás un archivo de imagen de un bucket de Cloud Storage.

• bucket: Ingresa el nombre del depósito que contenga ambos archivos de imagen de demostración.
• object: Ingresa demo-image1.png. Tu método debería verse de esta manera:

3. 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 credenciales, haz clic en el ícono de signo de interrogación que aparece junto al título Credenciales.

4. Asegúrate de que no haya espacios finales en los campos.

5. Ahora desplázate hacia abajo y haz clic en Ejecutar.

Deberías obtener un resultado similar al siguiente:

6. Ahora borra la segunda imagen del bucket Cloud Storage. En el mismo método, para el campo object, ingresa demo-image2.png. Tu nombre de bucket no se modificará. Tu método debería verse de esta manera:

7. Ahora desplázate hacia abajo y haz clic en Ejecutar. Deberías obtener un resultado similar al siguiente:

Borraste correctamente archivos de un bucket con el método objects.delete. A continuación, verás tu archivo que se quitó en la consola de Cloud.

Visualiza tu bucket actualizado en la consola de Cloud

1. Para este paso, regresa a la consola de Cloud. Deberías haberte detenido en la página de detalles de tu bucket de Cloud Storage.

2. En el menú de la izquierda, haz clic en Buckets y selecciona tu primer bucket. Deberías ver que se quitaron ambas imágenes.

Tarea 6. Borra el bucket de Cloud Storage

1. Desde la sección APIs y referencias ubicada a la izquierda, navega a API de JSON > Referencia de la API > Buckets > delete para usar el método buckets.delete, o bien, para borrar un bucket de Cloud Storage con el Explorador de APIs, usa Buckets: referencia de delete.

A continuación, borrarás tu primer bucket (vacío) de Cloud Storage.

2. En el campo bucket, ingresa el nombre de tu primer bucket. Tu método debería verse de esta manera:

3. 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 credenciales, haz clic en el ícono de signo de interrogación que aparece junto al título Credenciales.

4. Asegúrate de que no haya espacios finales en los campos.

5. Ahora desplázate hacia abajo y haz clic en Ejecutar. Deberías obtener un resultado similar al siguiente:

Borraste correctamente un bucket con el método buckets.delete.

Visualiza tu bucket actualizado en la consola de Cloud

1. Para este paso, regresa a la consola de Cloud. Deberías ver la página de detalles.

2. En el menú de la izquierda, haz clic en Buckets. Deberías ver que se quitó tu primer bucket.

Completaste correctamente todos los pasos del lab. Puedes finalizar el lab aquí o experimentar con algunos métodos nuevos en el tiempo que queda.

Tarea 7. Pon a prueba tus conocimientos

A continuación, se presentan algunas preguntas de opción múltiple para reforzar tus conocimientos de los conceptos de este lab. Trata de responderlas lo mejor posible.

¡Felicitaciones!

En este lab, creaste buckets de Cloud Storage con el Explorador de APIs. También copiaste y pegaste los archivos de imagen borrados con los métodos específicos del Explorador de APIs. Después de borrar archivos de imagen, aprendiste cómo borrar un bucket completo con el método delete. En este punto, tienes una comprensión sólida de Cloud Storage y de cómo aprovisionar los métodos de este servicio a través del Explorador de APIs.

Finaliza la Quest

Este lab de autoaprendizaje forma parte de la Quest Exploring APIs. 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 esta Quest y obtén un crédito inmediato de realización. Consulta el catálogo de Google Cloud Skills Boost para ver todas las Quests disponibles.

Próximos pasos/Más información

Para practicar más con el Explorador de APIs, prueba este lab:

Explorador de APIs: creación y actualización de un clúster

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: 1 de mayo de 2023

Prueba más reciente del lab: 8 de febrero 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.