En las guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace.
Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de API para manejar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. Antes de ejecutar la app de muestra, cada guía de inicio rápido requiere que actives la autenticación y la autorización. Si no estás familiarizado con la autenticación y la autorización para las API de Google Workspace, consulta la descripción general de autenticación y autorización.
Como administrador de Google Workspace, puedes usar la API del Centro de alertas para acceder a las alertas de problemas que afectan a tu dominio.
Objetivos
- Configurar el entorno
- Configura y ejecuta la muestra.
Requisitos previos
- Java 1.8 o superior
- Un proyecto de Google Cloud
- Una Cuenta de Google
Configura tu entorno
Activa la API
Antes de usar las API de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más API en un solo proyecto de Google Cloud.En Google Cloud Console, activa la API del Centro de alertas.
Crea una cuenta de servicio
Una cuenta de servicio es un tipo especial de cuenta que usa una aplicación, en lugar de una persona. Puedes usar una cuenta de servicio para acceder a los datos o realizar acciones mediante la cuenta del robot, o acceder a los datos en nombre de los usuarios de Google Workspace o Cloud Identity. Para obtener más información, consulta Comprende las cuentas de servicio.- En Google Cloud Console, ve a Menú > IAM y administración > Cuentas de servicio.
- Haz clic en Crear cuenta de servicio.
- Completa los detalles de la cuenta de servicio y, luego, haz clic en Crear y continuar.
- Opcional: Asigna funciones a tu cuenta de servicio para otorgar acceso a los recursos de tu proyecto de Google Cloud. Para obtener más información, consulta Otorga, cambia y revoca el acceso a los recursos.
- Haz clic en Continuar.
- Opcional: Ingresa usuarios o grupos que puedan administrar y realizar acciones con esta cuenta de servicio. Para obtener más detalles, consulta Cómo administrar el robo de identidad de cuentas de servicio.
- Haz clic en Listo.
Crea credenciales para una cuenta de servicio
Debes obtener las credenciales en forma de un par de clave pública/privada. Tu código usa estas credenciales para autorizar las acciones de la cuenta de servicio dentro de tu app.- En Google Cloud Console, ve a Menú > IAM y administración > Cuentas de servicio.
- Selecciona tu cuenta de servicio.
- Haz clic en Claves > Agregar clave > Crear clave nueva.
- Selecciona JSON y haz clic en Crear.
Ya se generó y se descargó el nuevo par de claves pública/privada en tu máquina como un archivo nuevo. Este archivo es la única copia de la clave. Para obtener información sobre cómo almacenar tu clave de forma segura, consulta Administra claves de cuentas de servicio.
- Haz clic en Cerrar.
Configura y ejecuta la muestra
Obtén credenciales:
Crea una instancia del cliente:
Mostrar todas las alertas:
Proporciona comentarios sobre una alerta determinada: