Class Trigger

Pemicu:

Pemicu skrip.

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
getEventType()EventTypeMenampilkan jenis peristiwa yang memicu pemicu.
getHandlerFunction()StringMenampilkan fungsi yang dipanggil saat pemicu diaktifkan.
getTriggerSource()TriggerSourceMenampilkan sumber peristiwa yang 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 memicu 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 pemicu ini.

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 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 menyebabkan pemicu diaktifkan.

Misalnya, pemicu onEdit spreadsheet menampilkan SPREADSHEETS, atau pemicu berbasis waktu 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 — Penerbit yang memicu notifikasi 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 pemicunya adalah spreadsheet, ini adalah ID spreadsheet. Untuk peristiwa jam, fungsi ini menampilkan null.

Pulang pergi

String — ID entitas di penayang yang memicu ini.

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