GSP154

Descripción general

Google Cloud Video Intelligence permite que los videos puedan buscarse y descubrirse mediante la extracción de metadatos con una API de REST fácil de usar. Ahora puedes realizar búsquedas en todos los momentos de cada archivo de video del catálogo. Esta API genera anotaciones con rapidez sobre videos almacenados en Cloud Storage y te ayuda a identificar entidades clave (sustantivos) en tu video, así como el momento en el que aparecen. Separa la señal del ruido y recupera información relevante de todo un video, ya sea por toma o por fotograma.

Actividades

En este lab, aprenderás a realizar las siguientes tareas:

• Configurar la autorización de una cuenta de servicio personalizada
• Enviar una solicitud para anotar un video a la API de Video Intelligence

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.

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.

1. Haz clic en Activar Cloud Shell en la parte superior de la consola 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 YOUR_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.

2. Puedes solicitar el nombre de la cuenta activa con este comando (opcional):

gcloud auth list

3. Haz clic en Autorizar.

4. Ahora, el resultado debería verse de la siguiente manera:

Resultado:

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`

5. Puedes solicitar el ID del proyecto con este comando (opcional):

gcloud config list project

Resultado:

[core] project = <project_ID>

Resultado de ejemplo:

[core] project = qwiklabs-gcp-44776a13dea667a6 Nota: Para obtener toda la documentación de gcloud, consulta la guía con la descripción general de gcloud CLI en Google Cloud.

Tarea 1. Configura la autorización

Para este lab, crearás y usarás una cuenta de servicio vinculada a tu proyecto de Google Cloud para la autorización.

1. En Cloud Shell, ejecuta el siguiente comando para crear una nueva cuenta de servicio llamada quickstart:

gcloud iam service-accounts create quickstart

2. Crea un archivo de claves de la cuenta de servicio. Para ello, reemplaza <your-project-123> por el ID de tu proyecto:

gcloud iam service-accounts keys create key.json --iam-account quickstart@<your-project-123>.iam.gserviceaccount.com

3. Ahora autentica tu cuenta de servicio pasando la ubicación del archivo de claves de la cuenta de servicio:

gcloud auth activate-service-account --key-file key.json

4. Obtén un token de autorización con tu cuenta de servicio:

gcloud auth print-access-token

El token se imprimirá en la salida, y lo utilizarás en un paso posterior.

Haz clic en Revisar mi progreso para verificar el objetivo. Configurar la autorización

Tarea 2. Haz una solicitud para anotar un video

Nota: En este lab, la API de Cloud Video Intelligence ya está habilitada para ti.

1. Ejecuta este comando para crear un archivo de solicitud JSON con el siguiente texto y guárdalo como request.json:

cat > request.json <<EOF { "inputUri":"gs://spls/gsp154/video/train.mp4", "features": [ "LABEL_DETECTION" ] } EOF Nota: Para simplificar el proceso, se utilizará un video público de un tren disponible para el proyecto como el valor de inputUri. Si lo prefieres o si estás ejecutando el comando en un proyecto personal, puedes usar cualquier video que desees. Para ello, debes subirlo a Cloud Storage y proporcionar el correspondiente URI de Cloud Storage (formato: gs://bucket/object) como el valor de inputUri.

2. Usa curl para realizar una solicitud videos:annotate y pasa el nombre de archivo de la solicitud de la entidad:

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/videos:annotate' \ -d @request.json

La API de Video Intelligence crea una operación para procesar la solicitud. Ahora deberías ver una respuesta que incluya el nombre de la operación, que debería ser similar a esta:

{ "name": "projects/474887704060/locations/asia-east1/operations/16366331060670521152" }

Deberás usar el nombre, las ubicaciones y los proyectos de esta operación en el próximo paso.

3. Usa esta secuencia de comandos para solicitar información sobre la operación. Para ello, llama al extremo v1.operations. Reemplaza PROJECTS, LOCATIONS y OPERATION_NAME por el valor que acabas de recibir en el comando anterior:

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/projects/PROJECTS/locations/LOCATIONS/operations/OPERATION_NAME'

Ahora verás información relacionada con tu operación. Si se completó la operación, se incluirá el campo done y se establecerá en true:

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.Annota tionProgressMetadata", "progressMetadata": [ { "inputUri": "gs://spls/gsp154/video/train.mp4", "startTime": "2016-09-22T21:41:56.766091Z", "lastUpdateTime": "2016-09-22T21:42:03.889743Z" } ] }, ... }

4. Espera a que se procese la solicitud (por lo general, un minuto) y vuelve a ejecutar el comando. La misma solicitud mostrará los resultados anotados:

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/spls/gsp154/video/train.mp4", "progressPercent": 100, "startTime": "2017-02-17T22:39:00.333942Z", "updateTime": "2017-02-17T22:39:11.414399Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/spls/gsp154/video/train.mp4", "segmentLabelAnnotations": [ { "entity": { "entityId": "/m/01yrx", "languageCode": "en-US" }, "segments": [ { "segment": { "startTimeOffset": "0s", "endTimeOffset": "14.833664s" }, "confidence": 0.98509187 } ] }, ...

Ya enviaste tu primera solicitud a la API de Cloud Video Intelligence.

Haz clic en Revisar mi progreso para verificar el objetivo. Hacer una solicitud para anotar un video

¡Felicitaciones!

Enviaste una solicitud para anotar un video a la API de Video Intelligence y recibiste resultados.

Próximos pasos y más información

Este lab también forma parte de una serie de labs denominada Qwik Starts. Estos labs se diseñaron para ofrecerte una visión general de las numerosas funciones disponibles en Google Cloud. Busca “Qwik Starts” en el catálogo de Google Cloud Skills Boost para encontrar el siguiente lab en el que desees participar.

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: 4 de febrero de 2024

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