Class Trigger

트리거

스크립트 트리거

메서드

메서드반환 유형간략한 설명
getEventType()EventType트리거가 실행되는 이벤트 유형을 반환합니다.
getHandlerFunction()String트리거가 실행될 때 호출될 함수를 반환합니다.
getTriggerSource()TriggerSource트리거를 실행할 이벤트의 소스를 반환합니다.
getTriggerSourceId()String소스 고유의 ID를 반환합니다.
getUniqueId()String트리거를 서로 구분하는 데 사용할 수 있는 고유 식별자를 반환합니다.

자세한 문서

getEventType()

트리거가 실행되는 이벤트 유형을 반환합니다. 

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

리턴

EventType: 트리거의 이벤트 유형

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getHandlerFunction()

트리거가 실행될 때 호출될 함수를 반환합니다. 

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

리턴

String: 메서드 이름

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTriggerSource()

트리거를 실행할 이벤트의 소스를 반환합니다.

예를 들어 스프레드시트 onEdit 트리거는 SPREADSHEETS 또는 시간 기반 트리거를 반환합니다. CLOCK을 반환합니다. 

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

리턴

TriggerSource: 이 트리거가 트리거되는 게시자입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTriggerSourceId()

소스 고유의 ID를 반환합니다.

예를 들어 트리거 소스가 스프레드시트인 경우 이 ID는 스프레드시트입니다. 시계 이벤트의 경우 null을 반환합니다.

리턴

String: 트리거의 대상인 게시자의 항목 ID입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getUniqueId()

트리거를 서로 구분하는 데 사용할 수 있는 고유 식별자를 반환합니다.

리턴

String: 트리거의 고유 식별자입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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