Class Trigger

Activador

Un activador de secuencia de comandos

Métodos

Método	Tipo de datos que se muestra	Descripción breve
getEventType()	EventType	Muestra el tipo de evento en el que se activa el activador.
getHandlerFunction()	String	Muestra la función a la que se llamará cuando se active el activador.
getTriggerSource()	TriggerSource	Muestra la fuente de eventos que hará que se active el activador.
getTriggerSourceId()	String	Devuelve el ID específico de la fuente.
getUniqueId()	String	Devuelve 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.

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 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 ámbitos:

• 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 ámbitos:

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

---

getTriggerSource()

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

Por ejemplo, un activador onEdit de una hoja de cálculo mostraría HOJA_DE_CÁLCULO, o un activador basado en el tiempo mostraría RELOJ.

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 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 ámbitos:

• 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 sería el ID de la hoja de cálculo. Para los eventos de reloj, se muestra un valor 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 ámbitos:

• 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 ámbitos:

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