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