Los activadores simples y los activadores instalables permiten que Apps Script ejecute una función automáticamente si ocurre un evento determinado. Cuando se activa un activador, Apps Script pasa a la función un objeto de evento como argumento, que suele llamarse e. El objeto del evento contiene información sobre el contexto que provocó que se activara el activador. Por ejemplo, en el siguiente código de muestra, se muestra un activador onEdit(e) simple para una secuencia de comandos de Hojas de cálculo de Google que usa el objeto del evento para determinar qué celda se editó.
function onEdit(e){
// Set a comment on the edited cell to indicate when it was changed.
var range = e.range;
range.setNote('Last modified: ' + new Date());
}
En esta página, se detallan los campos del objeto de evento para diferentes tipos de activadores.
Eventos de Hojas de cálculo de Google
Los diversos activadores específicos de Hojas de cálculo de Google permiten que las secuencias de comandos respondan a las acciones de un usuario en una hoja de cálculo.
Abrir(simple y instalable). |
|
|---|---|
authMode |
Un valor de la enumeración LIMITED |
source |
Un objeto Spreadsheet |
triggerUid |
Es el ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
Cambiar(instalable) |
|
|---|---|
authMode |
Un valor de la enumeración FULL |
changeType |
El tipo de cambio ( INSERT_ROW |
source |
Un objeto
Spreadsheet |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
user |
Un objeto amin@example.com |
Editar(simple y instalable). |
|
|---|---|
authMode |
Un valor de la enumeración LIMITED |
oldValue |
Es el valor de la celda anterior a la edición, si corresponde. Solo está disponible si el rango editado es una sola celda. No se definirá si la celda no tenía contenido anterior. 1234 |
range |
Un objeto Range |
source |
Un objeto Spreadsheet |
triggerUid |
Es el ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
value |
Es el valor de celda nuevo después de la edición. Solo está disponible si el rango editado es una sola celda. 10 |
Envío de formulario(instalable) |
|
|---|---|
authMode |
Un valor de la enumeración FULL |
namedValues |
Un objeto que contiene los nombres y valores de las preguntas del envío del formulario. {
'First Name': ['Jane'],
'Timestamp': ['6/7/2015 20:54:13'],
'Last Name': ['Doe']
}
|
range |
Un objeto Range |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
values |
Es un array con valores en el mismo orden en que aparecen en la hoja de cálculo. ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
Eventos de Documentos de Google
Los activadores permiten que Documentos de Google responda cuando un usuario abre un documento.
Abrir(simple y instalable). |
|
|---|---|
authMode |
Un valor de la enumeración LIMITED |
source |
Un objeto Document |
triggerUid |
Es el ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
Eventos de Presentaciones de Google
Los activadores permiten que Presentaciones de Google responda cuando un usuario abre una presentación.
Abrir(simple) |
|
|---|---|
authMode |
Un valor de la enumeración LIMITED |
source |
Un objeto Presentation |
user |
Un objeto amin@example.com |
Eventos de Formularios de Google
Los activadores específicos de Formularios de Google permiten que las secuencias de comandos respondan cuando un usuario edita un formulario o envía una respuesta.
Abrir* (simple y instalable) |
|
|---|---|
authMode |
Un valor de la enumeración LIMITED |
source |
Un objeto Form |
triggerUid |
Es el ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
* Este evento no se produce cuando un usuario abre un formulario para responderlo, sino cuando un editor lo abre para modificarlo.
Envío de formulario(instalable) |
|
|---|---|
authMode |
Un valor de la enumeración FULL |
response |
Un objeto FormResponse |
source |
Un objeto Form |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
Eventos del Calendario de Google
El activador de Calendario se activa cuando se actualizan los eventos del calendario de un usuario (se crean, se editan o se borran).
Estos activadores no te indican qué evento cambió ni cómo lo hizo. En cambio, indican que tu código debe realizar una operación de sincronización incremental para detectar los cambios recientes en el calendario. Para obtener una descripción completa de este procedimiento, consulta la guía de sincronización de recursos de la API de Calendario.
Para sincronizar con el Calendario en Apps Script, sigue estos pasos:
- Habilita el servicio avanzado de Calendario para el proyecto de secuencia de comandos. El servicio de Calendario integrado no es suficiente para este flujo de trabajo.
- Determina qué calendarios se deben sincronizar. Para cada uno de esos calendarios, realiza una operación de sincronización inicial con el método Events.list() del servicio avanzado de Calendario.
- El resultado de la sincronización inicial muestra un
nextSyncTokenpara ese calendario. Almacena este token para usarlo más adelante. - Cuando se active el activador
EventUpdatedde Apps Script que indica un cambio en un evento del calendario, realiza una sincronización incremental del calendario afectado con elnextSyncTokenalmacenado. En esencia, esta es otra solicitud Events.list(), pero proporcionarnextSyncTokenlimita la respuesta solo a los eventos que cambiaron desde la última sincronización. - Examina la respuesta de la sincronización para saber qué eventos se actualizaron y haz que tu código responda de forma adecuada. Por ejemplo, puedes registrar el cambio, actualizar una hoja de cálculo, enviar avisos por correo electrónico o realizar otras acciones.
- Actualiza el
nextSyncTokenque almacenaste para ese calendario con el que muestra la solicitud de sincronización incremental. Esto obliga a que la próxima operación de sincronización solo muestre los cambios más recientes.
EventUpdated(instalable) |
|
|---|---|
authMode |
Un valor de la enumeración FULL |
calendarId |
El ID de cadena del calendario en el que se realizó la actualización del evento. susan@example.com |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
Eventos de complementos de Google Workspace
El activador onInstall() se ejecuta automáticamente cuando un usuario instala un complemento.
Instalar(simple) |
|
|---|---|
authMode |
Un valor de la enumeración FULL |
Eventos de la app de Google Chat
Para obtener información sobre los objetos de eventos en Google Chat, consulta Cómo recibir y responder interacciones con tu app de Google Chat.
Eventos basados en el tiempo
Los activadores basados en el tiempo (también llamados activadores de reloj) permiten que las secuencias de comandos se ejecuten en un momento determinado o en un intervalo recurrente.
| Basado en el tiempo (instalable) | |
|---|---|
authMode |
Un valor de la enumeración FULL |
day-of-month |
Entre Debido a que este nombre de propiedad contiene guiones, se debe acceder a él a través de 31 |
day-of-week |
Entre Debido a que este nombre de propiedad contiene guiones, se debe acceder a él a través de 7 |
hour |
Entre 23 |
minute |
Entre 59 |
month |
Entre 12 |
second |
Entre 59 |
timezone |
La zona horaria UTC |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
week-of-year |
Entre Debido a que este nombre de propiedad contiene guiones, se debe acceder a él a través de 52 |
year |
El año. 2015 |