Activadores simples y
los activadores instalables permiten que Apps Script
ejecutar una función automáticamente si ocurre un evento determinado. Cuando se activa un activador,
Apps Script pasa la función un objeto de evento como argumento, generalmente llamado
e
El objeto event contiene información sobre el contexto que provocó el
activador se active. Por ejemplo, en el siguiente código de muestra, se muestra un onEdit(e)
simple.
activador de una secuencia de comandos de Hojas de cálculo de Google que usa el objeto de evento para determinar cuál
se editó la celda.
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());
}
Esta página detalla los campos en el objeto de evento para diferentes tipos de activadores.
Eventos de Hojas de cálculo de Google
Los distintos activadores específicos de Hojas de cálculo de Google permiten que las secuencias de comandos respondan a la solicitud de un usuario acciones en una hoja de cálculo.
Abrir(simples y instalable) |
|
---|---|
authMode |
Es un valor de la enum LIMITED |
source |
Un objeto Spreadsheet |
triggerUid |
ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
Cambiar(instalable) |
|
---|---|
authMode |
Es un valor de la enum FULL |
changeType |
El tipo de cambio ( INSERT_ROW |
source |
Un
Spreadsheet |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
user |
Un objeto amin@example.com |
Editar(simples y instalable) |
|
---|---|
authMode |
Es un valor de la enum LIMITED |
oldValue |
Valor de celda anterior a la edición, si corresponde. Solo está disponible si se editó rango es una sola celda. No estará definida si la celda no tiene valores previos contenido. 1234 |
range |
Un objeto Range |
source |
Un objeto Spreadsheet |
triggerUid |
ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
value |
Nuevo valor de celda después de la edición. Solo está disponible si el rango editado es una una sola celda. 10 |
Envío de formulario(instalable) |
|
---|---|
authMode |
Es un valor de la enum FULL |
namedValues |
Un objeto que contiene los nombres de las preguntas y los valores 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 |
Arreglo 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(simples y instalable) |
|
---|---|
authMode |
Es un valor de la enum LIMITED |
source |
Un objeto Document |
triggerUid |
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 |
Es un valor de la enum 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 |
Es un valor de la enum LIMITED |
source |
Un objeto Form |
triggerUid |
ID del activador que produjo este evento (solo activadores instalables). 4034124084959907503 |
user |
Un objeto amin@example.com |
* Este evento no ocurre cuando un usuario abre un formulario para responder, sino cuando un editor abre el formulario para modificarlo.
Envío de formulario(instalable) |
|
---|---|
authMode |
Es un valor de la enum 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
Los activadores de Calendario se activan cuando se actualizan los eventos de calendario de un usuario (se crean, editarse o borrarse).
Estos activadores no indican qué evento cambió ni cómo cambió. En cambio, indican que tu código necesita realizar una operación de sincronización incremental. para registrar los cambios recientes en el calendario. Para obtener una descripción completa de este procedimiento, consulta la Guía de recursos de sincronización para el API de Calendar.
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 sistema integrado El servicio de Calendario no es suficiente para este flujo de trabajo.
- Determina qué calendarios se deben sincronizar. Para cada uno de estos calendarios, realizar una sincronización inicial. con el servicio avanzado de Calendario Events.list().
- El resultado de la sincronización inicial muestra un
nextSyncToken
para ese calendario. Almacena este token para usarlo más tarde. - Cuando se activa el activador
EventUpdated
de Apps Script, lo que indica que se muestra un calendario cambiar un evento, realizar una sincronización incremental para el calendario afectado mediante elnextSyncToken
almacenado. Este es básicamente otra instancia de Events.list(). solicitud, pero proporcionarnextSyncToken
limita la respuesta solo a eventos que cambiaron desde la última sincronización. - Examina la respuesta de la sincronización para saber qué eventos se actualizaron y y hacer 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.
- Actualizar el
nextSyncToken
que almacenaste para ese calendario con el que se devolvió por la solicitud de sincronización incremental. Esto fuerza la siguiente operación de sincronización a solo muestran los cambios más recientes.
EventUpdated(instalable) |
|
---|---|
authMode |
Un valor de la
FULL |
calendarId |
El ID de cadena del calendario donde 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
Se ejecuta el activador onInstall()
.
automáticamente cuando un usuario instala un complemento.
Instalar(simple) |
|
---|---|
authMode |
Es un valor de la enum FULL |
Eventos de la app de Google Chat
Para obtener información sobre los objetos de eventos en Google Chat, consulta Recibe y responde las interacciones con tu app de Google Chat.
Eventos basados en el tiempo
Activadores basados en el tiempo (también llamados activadores de reloj) permiten que las secuencias de comandos se ejecuten a una hora en particular o en un en un intervalo recurrente.
Basado en el tiempo (instalable) | |
---|---|
authMode |
Es un valor de la enum FULL |
day-of-month |
Entre Debido a que el nombre de esta propiedad contiene guiones, se debe acceder a él con
31 |
day-of-week |
Entre Debido a que el nombre de esta propiedad contiene guiones, se debe acceder a él con
7 |
hour |
Entre 23 |
minute |
Entre 59 |
month |
Entre 12 |
second |
Entre 59 |
timezone |
Indica la zona horaria. UTC |
triggerUid |
Es el ID del activador que produjo este evento. 4034124084959907503 |
week-of-year |
Entre Debido a que el nombre de esta propiedad contiene guiones, se debe acceder a él con
52 |
year |
El año. 2015 |