Class TriggerBuilder

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
PemicuBuilder

Builder umum untuk pemicu skrip.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
forDocument(document)DocumentTriggerBuilderMembuat dan menampilkan DocumentTriggerBuilder yang terkait dengan dokumen tertentu.
forDocument(key)DocumentTriggerBuilderMembuat dan menampilkan DocumentTriggerBuilder yang terikat dengan dokumen dengan ID yang diberikan.
forForm(form)FormTriggerBuilderMembuat dan menampilkan FormTriggerBuilder yang terikat dengan formulir tertentu.
forForm(key)FormTriggerBuilderMembuat dan menampilkan FormTriggerBuilder yang terikat dengan formulir tersebut dengan ID yang diberikan.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderMembuat dan menampilkan SpreadsheetTriggerBuilder yang terkait dengan spreadsheet yang ditentukan.
forSpreadsheet(key)SpreadsheetTriggerBuilderMembuat dan menampilkan SpreadsheetTriggerBuilder yang terkait dengan spreadsheet dengan ID yang diberikan.
forUserCalendar(emailId)CalendarTriggerBuilderMenampilkan builder untuk membuat pemicu kalender.
timeBased()ClockTriggerBuilderMembuat dan menampilkan ClockTriggerBuilder untuk mem-build pemicu berbasis waktu.

Dokumentasi mendetail

forDocument(document)

Membuat dan menampilkan DocumentTriggerBuilder yang terkait dengan dokumen tertentu.

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

Parameter

NameJenisDeskripsi
documentDocumentdokumen

Return

DocumentTriggerBuilder — DocumentTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

forDocument(key)

Membuat dan menampilkan DocumentTriggerBuilder yang terikat dengan dokumen dengan ID yang diberikan.

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

Parameter

NameJenisDeskripsi
keyStringID untuk dokumen

Return

DocumentTriggerBuilder — DocumentTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

forForm(form)

Membuat dan menampilkan FormTriggerBuilder yang terikat dengan formulir tertentu.

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

Parameter

NameJenisDeskripsi
formFormformulir

Return

FormTriggerBuilder — FormTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

forForm(key)

Membuat dan menampilkan FormTriggerBuilder yang terikat dengan formulir tersebut dengan ID yang diberikan.

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

Parameter

NameJenisDeskripsi
keyStringID untuk formulir

Return

FormTriggerBuilder — FormTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

forSpreadsheet(sheet)

Membuat dan menampilkan SpreadsheetTriggerBuilder yang terkait dengan spreadsheet yang ditentukan.

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

Parameter

NameJenisDeskripsi
sheetSpreadsheetspreadsheet

Return

SpreadsheetTriggerBuilder — SpreadsheetTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

forSpreadsheet(key)

Membuat dan menampilkan SpreadsheetTriggerBuilder yang terkait dengan spreadsheet dengan ID yang diberikan.

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

Parameter

NameJenisDeskripsi
keyStringID untuk spreadsheet

Return

SpreadsheetTriggerBuilder — SpreadsheetTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

forUserCalendar(emailId)

Menampilkan builder untuk membuat pemicu kalender.

Parameter

NameJenisDeskripsi
emailIdStringID email pengguna kalender yang dipantau pemicu.

Return

CalendarTriggerBuilder — CalendarTriggerBuilder baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Membuat dan menampilkan ClockTriggerBuilder untuk mem-build pemicu berbasis waktu.

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

Return

ClockTriggerBuilder — ClockTriggerBuilder baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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