Class Trigger

Tetikleyici

Komut dosyası tetikleyicisi.

Yöntemler

YöntemDönüş türüKısa açıklama
getEventType()EventTypeTetikleyicinin etkinleştirdiği etkinlik türünü döndürür.
getHandlerFunction()StringTetikleyici etkinleştiğinde çağrılacak işlevi döndürür.
getTriggerSource()TriggerSourceTetikleyicinin etkinleşmesine neden olacak etkinliklerin kaynağını döndürür.
getTriggerSourceId()StringKaynağa özgü kimliği döndürür.
getUniqueId()StringTetikleyicileri birbirinden ayırt etmek için kullanılabilecek benzersiz bir tanımlayıcı döndürür.

Ayrıntılı belgeler

getEventType()

Tetikleyicinin etkinleştirdiği etkinlik türünü döndürür.

var triggers = ScriptApp.getProjectTriggers();
for (var 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
  }
}

Return

EventType: Bunun tetikleyici olduğu etkinlik türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getHandlerFunction()

Tetikleyici etkinleştiğinde çağrılacak işlevi döndürür.

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

Return

String: Yöntem adı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTriggerSource()

Tetikleyicinin etkinleşmesine neden olacak etkinliklerin kaynağını döndürür.

Örneğin, Düzenleme üzerindeki e-tablo tetikleyicisi SPREADSHEETS veya zamana dayalı bir tetikleyici CLOCK değerini döndürür.

var triggers = ScriptApp.getProjectTriggers();
for (var 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");
  }
}

Return

TriggerSource — bu tetikleyici için yayıncı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTriggerSourceId()

Kaynağa özgü kimliği döndürür.

Örneğin, tetikleyici kaynak bir e-tabloysa bu, e-tablonun kimliği olur. Saat etkinlikleri için bu, null değerini döndürür.

Return

String: Yayıncıdaki, bunun tetikleyici olduğu varlığın kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getUniqueId()

Tetikleyicileri birbirinden ayırt etmek için kullanılabilecek benzersiz bir tanımlayıcı döndürür.

Return

String: Tetikleyicinin benzersiz tanımlayıcısı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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