El servicio avanzado de eventos de Google Workspace te permite usar la API de Google Workspace Events en Apps Script. Esta API te permite suscribirte a los recursos de Google Workspace para que recibas eventos relevantes que te interesen. Los eventos representan cambios en los recursos, como cuando se crean, actualizan o borran recursos.
Requisitos previos
- Un proyecto de Apps Script que usa un proyecto estándar de Google Cloud en lugar del predeterminado que Apps Script crea automáticamente.
- Un tema de Pub/Sub creado en el mismo proyecto de Google Cloud para recibir eventos de suscripción Para crear un tema de Pub/Sub, consulta Crea un tema de Pub/Sub y suscríbete a él.
- Para suscribirte a eventos de Chat, debes tener una app de Google Chat configurada en la página de configuración de la API de Chat en la consola de Google Cloud. Para crear una app de Google Chat, consulta Compila una app de Google Chat con Apps Script.
Los permisos de autorización necesarios que se agregan al archivo
appsscript.json
del proyecto de Apps Script Los permisos necesarios dependen de los tipos de recursos y eventos de destino de las suscripciones. Para obtener más información, consulta Elige los permisos de la API de Google Workspace Events. Por ejemplo:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Reference
Para obtener más información sobre este servicio, consulta la documentación de referencia de la API de Google Workspace Events. Al igual que todos los servicios avanzados de Apps Script, el servicio de eventos de Google Workspace usa los mismos objetos, métodos y parámetros que la API pública.
Código de muestra
En estas muestras, se indica cómo realizar acciones comunes de la API de Eventos de Google Workspace con el servicio avanzado.
Crea una suscripción
Para crear una suscripción a un recurso de Google Workspace, agrega la siguiente función al código del proyecto de Apps Script:
Enumerar suscripciones
Para enumerar las suscripciones filtradas por tipos de eventos y recursos de destino, agrega la siguiente función al código del proyecto de Apps Script:
Obtener suscripción
Para obtener información sobre una suscripción, agrega la siguiente función al código del proyecto de Apps Script:
Actualizar suscripción
Para actualizar o renovar una suscripción, agrega la siguiente función al código del proyecto de Apps Script:
Reactivar la suscripción
Para reactivar una suscripción, agrega la siguiente función al código del proyecto de Apps Script:
Borrar suscripción
Para borrar una suscripción, agrega la siguiente función al código del proyecto de Apps Script:
Obtener operación
La mayoría de los métodos de la API de Google Workspace Events muestran una operación de larga duración.
Para determinar el estado de la operación, puedes usar el método operations.get()
.
Para obtener información sobre una operación, agrega la siguiente función al código del proyecto de Apps Script:
Para obtener el nombre de una operación, usa el valor del campo name
que muestra uno de los métodos de la API de Eventos de Google Workspace, como subscriptions.create()
o subscriptions.patch()
.