Class Trigger

Trigger

Skript-Trigger

Methoden

MethodeRückgabetypKurzbeschreibung
getEventType()EventTypeGibt den Ereignistyp zurück, auf den der Trigger reagiert.
getHandlerFunction()StringGibt die Funktion zurück, die aufgerufen wird, wenn der Trigger ausgelöst wird.
getTriggerSource()TriggerSourceGibt die Quelle der Ereignisse zurück, die den Trigger auslösen.
getTriggerSourceId()StringGibt die spezifische ID der Quelle zurück.
getUniqueId()StringEine eindeutige Kennung, mit der sich Trigger voneinander unterscheiden lassen.

Detaillierte Dokumentation

getEventType()

Gibt den Ereignistyp zurück, auf den der Trigger reagiert.

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

Rückflug

EventType: Der Ereignistyp, für den dies ein Trigger ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getHandlerFunction()

Gibt die Funktion zurück, die aufgerufen wird, wenn der Trigger ausgelöst 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getTriggerSource()

Gibt die Quelle der Ereignisse zurück, die den Trigger auslösen.

Ein Trigger vom Typ „onEdit“ für eine Tabelle würde beispielsweise „TABELLEN“ zurückgeben, während ein zeitbasierter Trigger „UHR“ zurückgibt.

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`);
  }
}

Rückflug

TriggerSource – der Publisher, für den der Trigger gilt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getTriggerSourceId()

Gibt die spezifische ID der Quelle zurück.

Wenn die Triggerquelle beispielsweise eine Tabelle ist, ist dies die ID der Tabelle. Für Uhren-Ereignisse wird „null“ zurückgegeben.

Rückflug

String: Die ID der Entität im Publisher, für die dies ein Trigger ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getUniqueId()

Eine eindeutige Kennung, mit der sich Trigger voneinander unterscheiden lassen.

Rückflug

String: Die eindeutige Kennung des Triggers.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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