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 etkinleştirildiğinde çağrılacak işlevi döndürür.
getTriggerSource()TriggerSourceTetikleyicinin etkinleştirilmesine 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ı dokümanlar

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: Tetikleyicinin etkin olduğu etkinlik türü

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHandlerFunction()

Tetikleyici etkinleştirildiğ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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTriggerSource()

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

Örneğin, e-tabloda düzenleme yapıldığında 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: Tetikleyicinin ait olduğu yayıncı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTriggerSourceId()

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

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

Return

String: Yayıncıdaki tetikleyicinin ait olduğu öğenin kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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