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 los eventos que harán que el activador se active. |
getTriggerSourceId() | String | Muestra el ID específico de la fuente. |
getUniqueId() | String | Muestra 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