Class Trigger

트리거

스크립트 트리거

메서드

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

자세한 문서

getEventType()

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

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

리턴

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을 반환합니다.

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

리턴

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