Class Trigger

Activador

Un activador de secuencia de comandos

Métodos

MétodoTipo de datos que se muestraDescripción breve
getEventType()EventTypeMuestra el tipo de evento en el que se activa el activador.
getHandlerFunction()StringMuestra la función a la que se llamará cuando se active el activador.
getTriggerSource()TriggerSourceMuestra la fuente de los eventos que harán que el activador se active.
getTriggerSourceId()StringMuestra el ID específico de la fuente.
getUniqueId()StringMuestra un identificador único que se puede usar para distinguir los activadores entre sí.

Documentación detallada

getEventType()

Muestra el tipo de evento en el que se activa el activador.

var triggers = ScriptApp.getProjectTriggers();
for (var i = 0; i < triggers.length; i++) {
  if (triggers[i].getEventType() == ScriptApp.EventType.CLOCK) {
    // Some code here - other options are:
    // ScriptApp.EventType.ON_EDIT
    // ScriptApp.EventType.ON_FORM_SUBMIT
    // ScriptApp.EventType.ON_OPEN
  }
}

Volver

EventType: Es el tipo de evento para el que es activador.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.scriptapp

getHandlerFunction()

Muestra la función a la que se llamará cuando se active el activador.

// Create a trigger for the script.
ScriptApp.newTrigger('myFunction').forSpreadsheet('id of my spreadsheet').onEdit().create();
Logger.log(ScriptApp.getProjectTriggers()[0].getHandlerFunction()); // logs "myFunction"

Volver

String: Es el nombre del método.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.scriptapp

getTriggerSource()

Muestra la fuente de los eventos que harán que el activador se active.

Por ejemplo, un activador onEdit de una hoja de cálculo mostraría SPREADSHEETS, un activador basado en el tiempo mostraría CLOCK.

var triggers = ScriptApp.getProjectTriggers();
for (var i = 0; i < triggers.length; i++) {
  if (triggers[i].getTriggerSource() == ScriptApp.TriggerSource.CLOCK) {
    Logger.log(triggers[i].getUniqueId() + " source is clock");
  } else if (triggers[i].getTriggerSource() == ScriptApp.TriggerSource.SPREADSHEETS) {
    Logger.log(triggers[i].getUniqueId() + " source is spreadsheets");
  }
}

Volver

TriggerSource: Es el publicador para el que actúa como activador.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.scriptapp

getTriggerSourceId()

Muestra el ID específico de la fuente.

Por ejemplo, si la fuente del activador es una hoja de cálculo, este sería el ID del en una hoja de cálculo. En el caso de los eventos de reloj, el resultado es nulo.

Volver

String: Es el ID de la entidad en el publicador para la que es un activador.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.scriptapp

getUniqueId()

Muestra un identificador único que se puede usar para distinguir los activadores entre sí.

Volver

String: Es el identificador único del activador.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.scriptapp