Class TriggerBuilder

Kreator aktywatorów

Ogólny kreator dla wyzwalaczy skryptu.

Metody

MetodaZwracany typKrótki opis
forDocument(document)DocumentTriggerBuilderTworzy i zwraca obiekt DocumentTriggerBuilder powiązany z danym dokumentem.
forDocument(key)DocumentTriggerBuilderTworzy i zwraca obiekt DocumentTriggerBuilder powiązany z dokumentem o podanym identyfikatorze.
forForm(form)FormTriggerBuilderTworzy i zwraca FormTriggerBuilder powiązany z danym formularzem.
forForm(key)FormTriggerBuilderTworzy i zwraca obiekt FormTriggerBuilder powiązany z formularzem o podanym identyfikatorze.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderTworzy i zwraca element SpreadsheetTriggerBuilder powiązany z danym arkuszem kalkulacyjnym.
forSpreadsheet(key)SpreadsheetTriggerBuilderTworzy i zwraca obiekt SpreadsheetTriggerBuilder powiązany z arkuszem kalkulacyjnym o podanym identyfikatorze.
forUserCalendar(emailId)CalendarTriggerBuilderZwraca kreator do tworzenia wyzwalaczy kalendarza.
timeBased()ClockTriggerBuilderTworzy i zwraca obiekt ClockTriggerBuilder do tworzenia aktywatorów opartych na czasie.

Szczegółowa dokumentacja

forDocument(document)

Tworzy i zwraca obiekt DocumentTriggerBuilder powiązany z danym dokumentem. 

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

Parametry

NazwaTypOpis
documentDocumentdokumentu

Powrót

DocumentTriggerBuilder – nowy DocumentTriggerBuilder

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

forDocument(key)

Tworzy i zwraca obiekt DocumentTriggerBuilder powiązany z dokumentem o podanym identyfikatorze. 

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

Parametry

NazwaTypOpis
keyStringidentyfikator dokumentu.

Powrót

DocumentTriggerBuilder – nowy DocumentTriggerBuilder

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

forForm(form)

Tworzy i zwraca FormTriggerBuilder powiązany z danym formularzem. 

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

Parametry

NazwaTypOpis
formFormformularz

Powrót

FormTriggerBuilder – nowy element FormTriggerBuilder,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

forForm(key)

Tworzy i zwraca obiekt FormTriggerBuilder powiązany z formularzem o podanym identyfikatorze. 

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

Parametry

NazwaTypOpis
keyStringidentyfikator formularza.

Powrót

FormTriggerBuilder – nowy element FormTriggerBuilder,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

forSpreadsheet(sheet)

Tworzy i zwraca element SpreadsheetTriggerBuilder powiązany z danym arkuszem kalkulacyjnym. 

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

Parametry

NazwaTypOpis
sheetSpreadsheetarkusz kalkulacyjny

Powrót

SpreadsheetTriggerBuilder – nowy element SpreadsheetTriggerBuilder,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

forSpreadsheet(key)

Tworzy i zwraca obiekt SpreadsheetTriggerBuilder powiązany z arkuszem kalkulacyjnym o podanym identyfikatorze. 

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

Parametry

NazwaTypOpis
keyStringidentyfikator arkusza kalkulacyjnego,

Powrót

SpreadsheetTriggerBuilder – nowy element SpreadsheetTriggerBuilder,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

forUserCalendar(emailId)

Zwraca kreator do tworzenia wyzwalaczy kalendarza.

Parametry

NazwaTypOpis
emailIdStringIdentyfikator e-mail kalendarza użytkownika, który jest monitorowany przez regułę.

Powrót

CalendarTriggerBuilder – nowy obiekt CalendarTriggerBuilder.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • 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()

Tworzy i zwraca obiekt ClockTriggerBuilder do tworzenia aktywatorów opartych na czasie. 

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

Powrót

ClockTriggerBuilder – nowy obiekt ClockTriggerBuilder

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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