Class Trigger

Activador

Es un activador de secuencia de comandos.

Métodos

MétodoTipo de datos que se devuelveDescripción breve
getEventType()EventTypeDevuelve el tipo de evento en el que se activa el disparador.
getHandlerFunction()StringDevuelve la función que se llama cuando se activa el disparador.
getTriggerSource()TriggerSourceDevuelve la fuente de los eventos que hacen que se active el disparador.
getTriggerSourceId()StringDevuelve el ID específico de la fuente.
getUniqueId()StringDevuelve un identificador único que se puede usar para distinguir los activadores entre sí.

Documentación detallada

getEventType()

Devuelve el tipo de evento en el que se activa el disparador.

const triggers = ScriptApp.getProjectTriggers();
for (let 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 este 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

getHandlerFunction()

Devuelve la función que se llama cuando se activa el disparador.

// 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()

Devuelve la fuente de los eventos que hacen que se active el disparador.

Por ejemplo, un activador onEdit de una hoja de cálculo devuelve SPREADSHEETS, o un activador basado en el tiempo devuelve CLOCK.

const triggers = ScriptApp.getProjectTriggers();
for (let 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 se activa el disparador.

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()

Devuelve el ID específico de la fuente.

Por ejemplo, si la fuente del activador es una hoja de cálculo, este es el ID de la hoja de cálculo. Para los eventos de reloj, se devuelve null.

Volver

String: Es el ID de la entidad en el publicador para la que se activa este evento.

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()

Devuelve 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