Class TriggerBuilder

트리거빌더

스크립트 트리거의 일반 빌더입니다.

메서드

메서드반환 유형간략한 설명
forDocument(document)DocumentTriggerBuilder지정된 문서에 연결된 DocumentTriggerBuilder를 만들고 반환합니다.
forDocument(key)DocumentTriggerBuilder지정된 ID의 문서에 연결된 DocumentTriggerBuilder를 만들고 반환합니다.
forForm(form)FormTriggerBuilder지정된 양식에 연결된 FormTriggerBuilder를 만들고 반환합니다.
forForm(key)FormTriggerBuilder지정된 ID의 양식에 연결된 FormTriggerBuilder를 만들고 반환합니다.
forSpreadsheet(sheet)SpreadsheetTriggerBuilder지정된 스프레드시트에 연결된 SpreadsheetTriggerBuilder를 만들고 반환합니다.
forSpreadsheet(key)SpreadsheetTriggerBuilder지정된 ID로 스프레드시트에 연결된 SpreadsheetTriggerBuilder를 만들고 반환합니다.
forUserCalendar(emailId)CalendarTriggerBuilder캘린더 트리거를 빌드하기 위한 빌더를 반환합니다.
timeBased()ClockTriggerBuilder시간 기반 트리거를 빌드하기 위한 ClockTriggerBuilder를 만들고 반환합니다.

자세한 문서

forDocument(document)

지정된 문서에 연결된 DocumentTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction')
    .forDocument(DocumentApp.getActiveDocument())
    .onOpen()
    .create();

매개변수

이름유형설명
documentDocument문서

리턴

DocumentTriggerBuilder: 새 DocumentTriggerBuilder

승인

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forDocument(key)

지정된 ID의 문서에 연결된 DocumentTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction')
    .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
    .onOpen()
    .create();

매개변수

이름유형설명
keyString문서의 ID

리턴

DocumentTriggerBuilder: 새 DocumentTriggerBuilder

승인

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forForm(form)

지정된 양식에 연결된 FormTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction')
    .forForm(FormApp.getActiveForm())
    .onFormSubmit()
    .create();

매개변수

이름유형설명
formForm양식

리턴

FormTriggerBuilder: 새 FormTriggerBuilder

승인

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

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forForm(key)

지정된 ID의 양식에 연결된 FormTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction')
    .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
    .onFormSubmit()
    .create();

매개변수

이름유형설명
keyString양식의 ID

리턴

FormTriggerBuilder: 새 FormTriggerBuilder

승인

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

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forSpreadsheet(sheet)

지정된 스프레드시트에 연결된 SpreadsheetTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();

매개변수

이름유형설명
sheetSpreadsheet스프레드시트

리턴

SpreadsheetTriggerBuilder: 새 SpreadsheetTriggerBuilder

승인

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forSpreadsheet(key)

지정된 ID로 스프레드시트에 연결된 SpreadsheetTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
    .onEdit()
    .create();

매개변수

이름유형설명
keyString스프레드시트의 ID

리턴

SpreadsheetTriggerBuilder: 새 SpreadsheetTriggerBuilder

승인

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forUserCalendar(emailId)

캘린더 트리거를 빌드하기 위한 빌더를 반환합니다.

매개변수

이름유형설명
emailIdString트리거가 모니터링하는 사용자 캘린더의 이메일 ID입니다.

리턴

CalendarTriggerBuilder: 새 CalendarTriggerBuilder입니다.

승인

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

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.readonly
  • https://www.google.com/calendar/feeds

timeBased()

시간 기반 트리거를 빌드하기 위한 ClockTriggerBuilder를 만들고 반환합니다. 

ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 10, 31).create();

리턴

ClockTriggerBuilder: 새 ClockTriggerBuilder

승인

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

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