Class TriggerBuilder

TriggerBuilder

Ein generischer Builder für Scripttrigger.

Methoden

MethodeRückgabetypKurzbeschreibung
forDocument(document)DocumentTriggerBuilderErstellt und gibt einen DocumentTriggerBuilder zurück, der 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 einen FormTriggerBuilder zurück, der mit dem angegebenen Formular verknüpft ist.
forForm(key)FormTriggerBuilderErstellt und gibt einen FormTriggerBuilder zurück, der mit dem Formular mit der angegebenen ID verknüpft ist.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderErstellt und gibt einen SpreadsheetTriggerBuilder zurück, der mit der angegebenen Tabelle verknüpft ist.
forSpreadsheet(key)SpreadsheetTriggerBuilderErstellt und gibt ein SpreadsheetTriggerBuilder zurück, das mit der angegebenen ID mit der Tabelle verknüpft ist.
forUserCalendar(emailId)CalendarTriggerBuilderGibt einen Builder zum Erstellen von Kalendertriggern zurück.
timeBased()ClockTriggerBuilderErstellt und gibt eine ClockTriggerBuilder zum Erstellen zeitbasierter Trigger zurück.

Detaillierte Dokumentation

forDocument(document)

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

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

Parameter

NameTypBeschreibung
documentDocumentdas Dokument

Rückflug

DocumentTriggerBuilder – der neue DocumentTriggerBuilder

Autorisierung

Scripts, 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 für das Dokument

Rückflug

DocumentTriggerBuilder – der neue DocumentTriggerBuilder

Autorisierung

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

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

forForm(form)

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

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

Parameter

NameTypBeschreibung
formFormdas Formular

Rückflug

FormTriggerBuilder – der neue FormTriggerBuilder

Autorisierung

Scripts, 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 einen FormTriggerBuilder zurück, der 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

Rückflug

FormTriggerBuilder – der neue FormTriggerBuilder

Autorisierung

Scripts, 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 einen SpreadsheetTriggerBuilder zurück, der mit der angegebenen Tabelle verknüpft ist. 

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

Parameter

NameTypBeschreibung
sheetSpreadsheetTabelle

Rückflug

SpreadsheetTriggerBuilder – der neue SpreadsheetTriggerBuilder

Autorisierung

Scripts, 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 ein SpreadsheetTriggerBuilder zurück, das mit der angegebenen ID mit der Tabelle verknüpft ist. 

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

Parameter

NameTypBeschreibung
keyStringdie ID der Tabelle

Rückflug

SpreadsheetTriggerBuilder – der neue SpreadsheetTriggerBuilder

Autorisierung

Scripts, 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
emailIdStringDie E-Mail-ID des Nutzers, dessen Kalender der Trigger überwacht.

Rückflug

CalendarTriggerBuilder – die neue Klasse „CalendarTriggerBuilder“.

Autorisierung

Scripts, 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 und gibt eine ClockTriggerBuilder zum Erstellen zeitbasierter Trigger zurück. 

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

Rückflug

ClockTriggerBuilder – der neue ClockTriggerBuilder

Autorisierung

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

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