Antes de comenzar

En esta página, se muestra cómo configurar un proyecto de Google Cloud y cómo configurar cuentas de servicio para acceder al proyecto.

Configura un proyecto de Google Cloud

Seguir estos pasos para configurar un proyecto de Google Cloud

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. Habilita las API de Video Stitcher and Live Stream.

   Habilita las API

5. Crear una cuenta de servicio:

   1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

      Ve a Crear cuenta de servicio
   2. Elige tu proyecto.

   3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

   4. Haz clic en Crear y continuar.

   5. Otorga los siguientes roles a la cuenta de servicio: Video Stitcher Admin, Live Stream Editor, Storage Admin.

      Para otorgar un rol, busca la lista Selecciona un rol y, luego, selecciona el rol.

      Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.

      Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
   6. Haga clic en Continuar.

   7. Haz clic en Listo para terminar de crear la cuenta de servicio.

      No cierres la ventana del navegador. La usarás en la próxima tarea.

6. Haz lo siguiente para crear una clave de cuenta de servicio:

   1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
   2. Haga clic en Claves.
   3. Haz clic en Agregar clave y, luego, en Crear clave nueva.
   4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
   5. Haga clic en Cerrar.

7. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

   Ejemplo: Linux o macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

   Por ejemplo:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Ejemplo: Windows

   Para PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

   Por ejemplo:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Para el símbolo del sistema:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

8. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

9. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

10. Habilita las API de Video Stitcher and Live Stream.

    Habilita las API

11. Crear una cuenta de servicio:

    1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

       Ve a Crear cuenta de servicio
    2. Elige tu proyecto.

    3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

       Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

    4. Haz clic en Crear y continuar.

    5. Otorga los siguientes roles a la cuenta de servicio: Video Stitcher Admin, Live Stream Editor, Storage Admin.

       Para otorgar un rol, busca la lista Selecciona un rol y, luego, selecciona el rol.

       Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.

       Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
    6. Haga clic en Continuar.

    7. Haz clic en Listo para terminar de crear la cuenta de servicio.

       No cierres la ventana del navegador. La usarás en la próxima tarea.

12. Haz lo siguiente para crear una clave de cuenta de servicio:

    1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
    2. Haga clic en Claves.
    3. Haz clic en Agregar clave y, luego, en Crear clave nueva.
    4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
    5. Haga clic en Cerrar.

13. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

    Ejemplo: Linux o macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

    Por ejemplo:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Ejemplo: Windows

    Para PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

    Por ejemplo:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Para el símbolo del sistema:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

14. Instala Google Cloud CLI.

15. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init

    Nota: Puedes ejecutar la CLI de gcloud en la consola de Google Cloud sin instalar Google Cloud CLI. Para ejecutar la CLI de gcloud en la consola de Google Cloud, usa Cloud Shell.
16. Usa la herramienta de gcloud para probar tu entorno de autenticación. Verifica que el siguiente resultado del comando muestre una string de texto sin errores:

    gcloud auth application-default print-access-token

Activa la cuenta de servicio

1. En tu terminal, configura el proyecto activo para los comandos de gcloud. Reemplaza YOUR_PROJECT_ID por el ID del proyecto.

   gcloud config set project YOUR_PROJECT_ID
   

2. Activa la cuenta de servicio. Reemplaza PATH_TO_YOUR_SERVICE_KEY por la ruta de acceso al archivo JSON que descargaste en tu máquina local.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
   

Usarás esta cuenta de servicio para autorizar el acceso y llamar a la API de Video Stitcher.

Vincula la cuenta de servicio a la cuenta de Ad Manager

Una vez creada la cuenta de servicio, debes vincularla a tu cuenta de Ad Manager. Esto permite que la API de Video Stitcher cree eventos de transmisión en vivo en tu nombre. Sigue estos pasos para otorgar acceso a tu cuenta de servicio:

1. Accede a Google Ad Manager (GAM).
2. Haz clic en Administrador > Configuración global.
3. Asegúrate de que el acceso a la API esté habilitado.
4. Haz clic en Agregar un usuario de cuenta de servicio.
5. Completa el formulario, incluida la dirección de correo electrónico de la cuenta de servicio creada con anterioridad.
6. Selecciona una función, que debe incluir el permiso Administrar contenido de video con la inserción de anuncios dinámicos desde la Herramienta de unión de videos de Google Cloud. Debes crear una función personalizada llamada Administrador de transmisiones en vivo específicamente para administrar esta cuenta de servicio. El rol personalizado debe tener, como mínimo, los siguientes permisos:
   • Administrar el contenido de video con la inserción de anuncios dinámicos desde Video Stitcher de Google Cloud
   • Ver creatividades (obligatorio según el permiso anterior)
   • Cómo ver contenido, paquetes y metadatos de video
   • Ver fuentes del contenido
7. Haz clic en Guardar y confirma la incorporación de la cuenta de servicio.

Crea una cuenta de servicio con permisos solo para crear sesiones

Dado que se pasará un token de OAuth a una aplicación cliente, debes crear una cuenta de servicio independiente con solo permisos para crear una sesión. Por lo tanto, un token de OAuth filtrado no puede comprometer tus recursos, como las claves de CDN y los eventos de transmisión en vivo.

Crear una cuenta de servicio:

1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

   Ve a Crear cuenta de servicio
2. Elige tu proyecto.

3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

   Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

4. Haz clic en Crear y continuar.

5. Otorga los siguientes roles a la cuenta de servicio: Video Stitcher User.

   Para otorgar un rol, busca la lista Selecciona un rol y, luego, selecciona el rol.

   Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.

   Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
6. Haga clic en Continuar.

7. Haz clic en Listo para terminar de crear la cuenta de servicio.

   No cierres la ventana del navegador. La usarás en la próxima tarea.

Haz lo siguiente para crear una clave de cuenta de servicio:

1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
2. Haga clic en Claves.
3. Haz clic en Agregar clave y, luego, en Crear clave nueva.
4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
5. Haga clic en Cerrar.