Los activadores de Apps Script generan una secuencia de comandos especificada función (la función de activador) para que se ejecute cada vez que un evento especificado de que ocurra. Solo algunos eventos pueden hacer que se activen los activadores La aplicación de Google Workspace admite un conjunto diferente de eventos.
Cuando se activa un activador, se crea un objeto de evento. Esta estructura JSON contiene detalles sobre el evento que se produjo. La información del evento de objetos está organizada de manera diferente según el tipo de activador.
Una vez que se crea el objeto de evento, Apps Script lo pasa como parámetro al objeto función de activación. La función trigger es una función de devolución de llamada que debes implementar por tu cuenta, tomar las medidas adecuadas para responder al para cada evento. Por ejemplo, en una complemento de Google Workspace que extiende Gmail, puedes definir un activador que cree una nueva interfaz de tarjeta cuando el usuario abra un mensaje conversación. En este caso, implementarás una función de devolución de llamada contextual para crear las tarjetas que componen la nueva IU con los datos que se pasaron en el objeto de evento.
En esta página, se brindan lineamientos sobre el uso de activadores Google Workspace proyectos complementarios.
Activadores de manifiestos
A diferencia de los complementos de Editor, los complementos de Google Workspace actualmente, no puede usar activadores simples de Apps Script En cambio, usan activadores diseñados específicamente para Complementos de Google Workspace: Activadores de manifiestos
Los activadores de manifiesto se definen completamente en el del complemento de Google Workspace manifiesto. Algunos ejemplos de activadores de manifiestos incluyen el lo siguiente:
- Activadores de la página principal que compilan y muestran la página principal del complemento
- Activadores de EventOpen de Calendario que muestren una tarjeta o toma otras acciones cuando se abre un evento de Calendario.
- Activadores de Calendar eventUpdate que muestren una tarjeta nueva o tomen y otras acciones cuando un usuario edita y guarda un evento de Calendario.
- Activadores de onItemsSelected de Drive que muestren una tarjeta nueva o tomen y otras acciones cuando un usuario selecciona uno o más archivos o carpetas de Drive.
- Activadores de redacción de Gmail que muestren una tarjeta de complemento cuando la el usuario abre el complemento en la ventana de redacción de Gmail.
- Activadores contextuales de Gmail que muestren una tarjeta nueva o tomen otras acciones cuando el usuario abre un mensaje de Gmail.
- Activadores de onFileScopeGranted del editor que muestran una tarjeta nueva cuando los usuarios
Otorgar autorización para el permiso de OAuth
drive.fileen el editor actual .
En la lista anterior, solo los activadores de la página principal no son contextuales. el resto son activadores contextuales. Consulta el Manifiesto para obtener más información sobre las definiciones de activadores de manifiesto.
Además de los activadores de manifiestos, Google Workspace los complementos también pueden usar Apps Script activadores instalables.
Restricciones
Los activadores de manifiesto tienen ciertas restricciones en cuanto a su uso.
- Estos activadores solo se usan en proyectos del complemento de Google Workspace. no tienen ningún propósito en ninguna otra aplicación.
- Como se definen en el manifiesto del complemento y no en su código, no puedes
usa Apps Script
Scriptpara crear o modificar estos activadores. - Actualmente, los activadores contextuales de Gmail solo pueden tener un criterio
unconditional. Esto significa que los activadores contextuales se activan para cada mensaje de correo electrónico, independientemente del contenido. - Cada complemento solo puede tener un activador de cada tipo, por usuario y por documento.