Class TriggerBuilder

TriggerBuilder

Ein allgemeiner Builder für Skript-Trigger.

Methoden

MethodeRückgabetypKurzbeschreibung
forDocument(document)DocumentTriggerBuilderErstellt und gibt eine DocumentTriggerBuilder zurück, die mit dem angegebenen Dokument verknüpft ist.
forDocument(key)DocumentTriggerBuilderErstellt und gibt ein DocumentTriggerBuilder zurück, das mit dem Dokument mit der angegebenen ID verknüpft ist.
forForm(form)FormTriggerBuilderErstellt und gibt ein FormTriggerBuilder zurück, das mit dem angegebenen Formular verknüpft ist.
forForm(key)FormTriggerBuilderErstellt und gibt ein FormTriggerBuilder zurück, das mit dem Formular mit der angegebenen ID verknüpft ist.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderErstellt und gibt eine SpreadsheetTriggerBuilder für die angegebene Tabelle zurück.
forSpreadsheet(key)SpreadsheetTriggerBuilderErstellt und gibt eine SpreadsheetTriggerBuilder zurück, die mit der Tabelle mit der angegebenen ID verknüpft ist.
forUserCalendar(emailId)CalendarTriggerBuilderGibt einen Builder zum Erstellen von Kalendertriggern zurück.
timeBased()ClockTriggerBuilderErstellt ein ClockTriggerBuilder zum Erstellen zeitbasierter Trigger und gibt es zurück.

Detaillierte Dokumentation

forDocument(document)

Erstellt und gibt eine DocumentTriggerBuilder zurück, die mit dem angegebenen Dokument verknüpft ist.

ScriptApp.newTrigger('myFunction')
  .forDocument(DocumentApp.getActiveDocument())
  .onOpen()
  .create();

Parameter

NameTypBeschreibung
documentDocumentdas Dokument

Return

DocumentTriggerBuilder – der neue DocumentTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forDocument(key)

Erstellt und gibt ein DocumentTriggerBuilder zurück, das mit dem Dokument mit der angegebenen ID verknüpft ist.

ScriptApp.newTrigger('myFunction')
  .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
  .onOpen()
  .create();

Parameter

NameTypBeschreibung
keyStringDie ID des Dokuments

Return

DocumentTriggerBuilder – der neue DocumentTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forForm(form)

Erstellt und gibt ein FormTriggerBuilder zurück, das mit dem angegebenen Formular verknüpft ist.

ScriptApp.newTrigger('myFunction')
  .forForm(FormApp.getActiveForm())
  .onFormSubmit()
  .create();

Parameter

NameTypBeschreibung
formFormdas Formular

Return

FormTriggerBuilder – der neue FormTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forForm(key)

Erstellt und gibt ein FormTriggerBuilder zurück, das mit dem Formular mit der angegebenen ID verknüpft ist.

ScriptApp.newTrigger('myFunction')
  .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
  .onFormSubmit()
  .create();

Parameter

NameTypBeschreibung
keyStringDie ID für das Formular

Return

FormTriggerBuilder – der neue FormTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forSpreadsheet(sheet)

Erstellt und gibt eine SpreadsheetTriggerBuilder für die angegebene Tabelle zurück.

ScriptApp.newTrigger('myFunction')
  .forSpreadsheet(SpreadsheetApp.getActive())
  .onEdit()
  .create();

Parameter

NameTypBeschreibung
sheetSpreadsheetdie Tabellenkalkulation

Return

SpreadsheetTriggerBuilder – der neue SpreadsheetTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forSpreadsheet(key)

Erstellt und gibt eine SpreadsheetTriggerBuilder zurück, die mit der Tabelle mit der angegebenen ID verknüpft ist.

ScriptApp.newTrigger('myFunction')
  .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
  .onEdit()
  .create();

Parameter

NameTypBeschreibung
keyStringDie ID der Tabelle

Return

SpreadsheetTriggerBuilder – der neue SpreadsheetTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forUserCalendar(emailId)

Gibt einen Builder zum Erstellen von Kalendertriggern zurück.

Parameter

NameTypBeschreibung
emailIdStringE-Mail-ID des Nutzerkalenders, den der Trigger überwacht.

Return

CalendarTriggerBuilder: Der neue CalendarTriggerBuilder.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.readonly
  • https://www.google.com/calendar/feeds

timeBased()

Erstellt ein ClockTriggerBuilder zum Erstellen zeitbasierter Trigger und gibt es zurück.

ScriptApp.newTrigger('myFunction')
  .timeBased()
  .atDate(2013, 10, 31)
  .create();

Return

ClockTriggerBuilder – der neue ClockTriggerBuilder

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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