Class Trigger

Tetikleyici

Komut dosyası tetikleyicisi.

Yöntemler

YöntemDönüş türüKısa açıklama
getEventType()EventTypeTetikleyicinin etkinleştiği etkinlik türünü döndürür.
getHandlerFunction()StringTetikleyici tetiklendiğinde çağrılan işlevi döndürür.
getTriggerSource()TriggerSourceTetikleyicinin etkinleştirilmesine neden olan etkinliklerin kaynağını döndürür.
getTriggerSourceId()StringKaynağa özel 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ştiği etkinlik türünü döndürür. 

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
  }
}

Return

EventType: Bu tetikleyicinin etkinleştirdiği etkinlik türü.

Yetkilendirme

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

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

getHandlerFunction()

Tetikleyici tetiklendiğinde çağrılan 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTriggerSource()

Tetikleyicinin etkinleştirilmesine neden olan etkinliklerin kaynağını döndürür.

Örneğin, e-tablo onEdit tetikleyicisi SPREADSHEETS değerini, zamana dayalı tetikleyici ise CLOCK değerini döndürür. 

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`);
  }
}

Return

TriggerSource: Bu tetikleyicinin geçerli olduğu yayıncı.

Yetkilendirme

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

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

getTriggerSourceId()

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

Örneğin, tetikleyici kaynağı bir e-tabloysa bu, e-tablonun kimliğidir. Saat etkinlikleri için null değeri döndürülür.

Return

String — Bunun tetikleyicisi olan yayıncıdaki varlığın kimliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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