Ein Skript-Trigger.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getEventType() | EventType | Gibt den Ereignistyp zurück, bei dem der Trigger ausgelöst wird. |
getHandlerFunction() | String | Gibt die Funktion zurück, die beim Auslösen des Triggers aufgerufen wird. |
getTriggerSource() | TriggerSource | Gibt die Quelle der Ereignisse zurück, durch die der Trigger ausgelöst wird. |
getTriggerSourceId() | String | Gibt die für die Quelle spezifische ID zurück |
getUniqueId() | String | Gibt eine eindeutige Kennung zurück, mit der Trigger voneinander unterschieden werden können. |
Detaillierte Dokumentation
getEventType()
Gibt den Ereignistyp zurück, bei dem der Trigger ausgelöst wird.
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 } }
Rückflug
EventType
– der Ereignistyp, für den dies ein Trigger ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.scriptapp
getHandlerFunction()
Gibt die Funktion zurück, die beim Auslösen des Triggers aufgerufen wird.
// Create a trigger for the script. ScriptApp.newTrigger('myFunction').forSpreadsheet('id of my spreadsheet').onEdit().create(); Logger.log(ScriptApp.getProjectTriggers()[0].getHandlerFunction()); // logs "myFunction"
Rückflug
String
– Der Methodenname
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSource()
Gibt die Quelle der Ereignisse zurück, durch die der Trigger ausgelöst wird.
Ein onEdit-Trigger in einer Tabelle gibt beispielsweise SPREADSHEETS oder ein zeitbasierter Trigger zurück. würde CLOCK zurückgeben.
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"); } }
Rückflug
TriggerSource
– der Publisher, für den er ausgelöst wird
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSourceId()
Gibt die für die Quelle spezifische ID zurück
Handelt es sich bei der Triggerquelle beispielsweise um eine Tabelle, wäre das die ID der Tabelle. Für Uhrereignisse wird null zurückgegeben.
Rückflug
String
– Die ID der Entität im Publisher, für die dies ein Trigger ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.scriptapp
getUniqueId()
Gibt eine eindeutige Kennung zurück, mit der Trigger voneinander unterschieden werden können.
Rückflug
String
: die eindeutige Kennung des Triggers
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/script.scriptapp