Objetos de evento

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 ScriptApp.AuthMode.

LIMITED
source

Un objeto Spreadsheet que representa el archivo de Hojas de cálculo de Google al que está vinculada la secuencia de comandos.

Spreadsheet
triggerUid

ID del activador que produjo este evento (solo activadores instalables).

4034124084959907503
user

Un objeto User que represente al usuario activo, si está disponible (según un conjunto complejo de restricciones de seguridad).

amin@example.com

Cambiar

(instalable)
authMode

Es un valor de la enum ScriptApp.AuthMode.

FULL
changeType

El tipo de cambio (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT o OTHER).

INSERT_ROW
source

Un Spreadsheet objeto, que representa el archivo de Hojas de cálculo de Google al que se dirige la secuencia de comandos de un recurso.

Spreadsheet
triggerUid

Es el ID del activador que produjo este evento.

4034124084959907503
user

Un objeto User que represente al usuario activo, si está disponible (según un conjunto complejo de restricciones de seguridad).

amin@example.com

Editar

(simples y instalable)
authMode

Es un valor de la enum ScriptApp.AuthMode.

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 que representa la celda o el rango de celdas que se editaron.

Range
source

Un objeto Spreadsheet que representa el archivo de Hojas de cálculo de Google al que está vinculada la secuencia de comandos.

Spreadsheet
triggerUid

ID del activador que produjo este evento (solo activadores instalables).

4034124084959907503
user

Un objeto User que represente al usuario activo, si está disponible (según un conjunto complejo de restricciones de seguridad).

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 ScriptApp.AuthMode.

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 que representa la celda o el rango de celdas que se editaron.

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 ScriptApp.AuthMode.

LIMITED
source

Un objeto Document que representa el archivo de Documentos de Google al que está vinculada la secuencia de comandos.

Document
triggerUid

ID del activador que produjo este evento (solo activadores instalables).

4034124084959907503
user

Un objeto User que represente al usuario activo, si está disponible (según un conjunto complejo de restricciones de seguridad).

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 ScriptApp.AuthMode.

LIMITED
source

Un objeto Presentation que representa el archivo de Presentaciones de Google al que está vinculada la secuencia de comandos.

Presentation
user

Un objeto User que represente al usuario activo, si está disponible (según un conjunto complejo de restricciones de seguridad).

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 ScriptApp.AuthMode.

LIMITED
source

Un objeto Form que representa el archivo de Formularios de Google al que está vinculada la secuencia de comandos.

Form
triggerUid

ID del activador que produjo este evento (solo activadores instalables).

4034124084959907503
user

Un objeto User que represente al usuario activo, si está disponible (según un conjunto complejo de restricciones de seguridad).

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 ScriptApp.AuthMode.

FULL
response

Un objeto FormResponse que representan la respuesta del usuario al formulario en su totalidad.

FormResponse
source

Un objeto Form que representa el archivo de Formularios de Google al que está vinculada la secuencia de comandos.

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:

  1. 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.
  2. Determina qué calendarios deben sincronizarse. Para cada uno de estos calendarios, realizar una sincronización inicial. con el servicio avanzado de Calendario Events.list().
  3. El resultado de la sincronización inicial muestra un nextSyncToken para ese calendario. Almacena este token para usarlo más tarde.
  4. 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 el nextSyncToken almacenado. Este es básicamente otra instancia de Events.list(). solicitud, pero proporcionar nextSyncToken limita la respuesta solo a eventos que cambiaron desde la última sincronización.
  5. Examina la respuesta de la sincronización para saber qué eventos se actualizaron y y hacer que tu código responda adecuadamente. Por ejemplo, puedes registrar el cambio, actualizar una hoja de cálculo, enviar avisos por correo electrónico o realizar otras acciones.
  6. 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 ScriptApp.AuthMode enum.

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 ScriptApp.AuthMode.

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 ScriptApp.AuthMode.

FULL
day-of-month

Entre 1 y 31.

Debido a que el nombre de esta propiedad contiene guiones, se debe acceder a él con e['day-of-month'] en lugar de la notación de puntos.

31
day-of-week

Entre 1 (lunes) y 7 (domingo).

Debido a que el nombre de esta propiedad contiene guiones, se debe acceder a él con e['day-of-week'] en lugar de la notación de puntos.

7
hour

Entre 0 y 23.

23
minute

Entre 0 y 59.

59
month

Entre 1 y 12.

12
second

Entre 0 y 59.

59
timezone

Indica la zona horaria.

UTC
triggerUid

Es el ID del activador que produjo este evento.

4034124084959907503
week-of-year

Entre 1 y 52.

Debido a que el nombre de esta propiedad contiene guiones, se debe acceder a él con e['week-of-year'] en lugar de la notación de puntos.

52
year

El año.

2015