Class Trigger

Pemicu

Pemicu skrip.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getEventType()EventTypeMenampilkan jenis peristiwa yang diaktifkan pemicu.
getHandlerFunction()StringMenampilkan fungsi yang akan dipanggil saat pemicu diaktifkan.
getTriggerSource()TriggerSourceMenampilkan sumber peristiwa yang akan menyebabkan pemicu diaktifkan.
getTriggerSourceId()StringMenampilkan ID khusus untuk sumber.
getUniqueId()StringMenampilkan ID unik yang dapat digunakan untuk membedakan pemicu satu sama lain.

Dokumentasi mendetail

getEventType()

Menampilkan jenis peristiwa yang diaktifkan pemicu.

const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  if (triggers[i].getEventType() === ScriptApp.EventType.CLOCK) {
    // Some code here - other options are:
    // ScriptApp.EventType.ON_EDIT
    // ScriptApp.EventType.ON_FORM_SUBMIT
    // ScriptApp.EventType.ON_OPEN
  }
}

Pulang pergi

EventType — jenis peristiwa yang menjadi pemicunya

Otorisasi

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

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

getHandlerFunction()

Menampilkan fungsi yang akan dipanggil saat pemicu diaktifkan.

// Create a trigger for the script.
ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('id of my spreadsheet')
    .onEdit()
    .create();
Logger.log(ScriptApp.getProjectTriggers()[0]
               .getHandlerFunction());  // logs "myFunction"

Pulang pergi

String — nama metode

Otorisasi

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

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

getTriggerSource()

Menampilkan sumber peristiwa yang akan menyebabkan pemicu diaktifkan.

Misalnya, pemicu onEdit spreadsheet akan menampilkan SPREADSHEETS, atau pemicu berbasis waktu akan menampilkan CLOCK.

const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  if (triggers[i].getTriggerSource() === ScriptApp.TriggerSource.CLOCK) {
    Logger.log(`${triggers[i].getUniqueId()} source is clock`);
  } else if (
      triggers[i].getTriggerSource() === ScriptApp.TriggerSource.SPREADSHEETS) {
    Logger.log(`${triggers[i].getUniqueId()} source is spreadsheets`);
  }
}

Pulang pergi

TriggerSource — penayang yang memicu peristiwa ini

Otorisasi

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

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

getTriggerSourceId()

Menampilkan ID khusus untuk sumber.

Misalnya, jika sumber pemicu adalah spreadsheet, ini akan menjadi ID spreadsheet. Untuk peristiwa jam, parameter ini akan menampilkan null.

Pulang pergi

String — ID entitas di penayang yang menjadi pemicunya

Otorisasi

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

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

getUniqueId()

Menampilkan ID unik yang dapat digunakan untuk membedakan pemicu satu sama lain.

Pulang pergi

String — ID unik pemicu

Otorisasi

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

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