Class TriggerBuilder

TriggerBuilder

Ein generischer Builder für Skripttrigger.

Methoden

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

Detaillierte Dokumentation

forDocument(document)

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

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

Parameter

NameTypBeschreibung
documentDocumentDas Dokument.

Rückflug

DocumentTriggerBuilder : Der neue DocumentTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

forDocument(key)

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

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

Parameter

NameTypBeschreibung
keyStringDie ID des Dokuments.

Rückflug

DocumentTriggerBuilder : Der neue DocumentTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

forForm(form)

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

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

Parameter

NameTypBeschreibung
formFormDas Formular.

Rückflug

FormTriggerBuilder : Der neue FormTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

forForm(key)

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

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

Parameter

NameTypBeschreibung
keyStringDie ID des Formulars.

Rückflug

FormTriggerBuilder : Der neue FormTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

forSpreadsheet(sheet)

Erstellt einen SpreadsheetTriggerBuilder, der mit der angegebenen Tabelle verknüpft ist, und gibt ihn zurück.

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

Parameter

NameTypBeschreibung
sheetSpreadsheetDie Tabelle.

Rückflug

SpreadsheetTriggerBuilder : Der neue SpreadsheetTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

forSpreadsheet(key)

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

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Nutzerkalenders, der vom Trigger überwacht wird.

Rückflug

CalendarTriggerBuilder : Der neue CalendarTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 einen ClockTriggerBuilder zum Erstellen zeitbasierter Trigger und gibt ihn zurück.

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

Rückflug

ClockTriggerBuilder : Der neue ClockTriggerBuilder.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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