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
  }
}

Devolvedor

EventType: Es el tipo de evento para el que funciona este 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"

Devolvedor

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, o un activador basado en el tiempo mostraría RELOJ.

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");
  }
}

Devolvedor

TriggerSource: El publicador es un activador para

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 de la hoja de cálculo. Para los eventos de reloj, el resultado es un valor nulo.

Devolvedor

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í.

Devolvedor

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