Script Service

Script

이 서비스를 통해 스크립트 트리거 및 스크립트 게시에 액세스할 수 있습니다.

클래스

이름간략한 설명
AuthMode트리거 함수를 통해 Apps Script가 실행할 수 있는 승인된 서비스의 카테고리를 식별하는 열거형입니다.
AuthorizationInfo사용자가 이 스크립트에서 하나 이상의 서비스를 사용하기 위해 승인해야 하는지 여부를 확인하고 승인 대화상자에 URL을 제공하는 데 사용되는 객체입니다.
AuthorizationStatus스크립트의 승인 상태를 나타내는 열거형입니다.
CalendarTriggerBuilder캘린더 트리거의 빌더입니다.
ClockTriggerBuilder시계 트리거의 빌더입니다.
DocumentTriggerBuilder문서 트리거용 빌더입니다.
EventType트리거된 이벤트의 유형을 나타내는 열거형입니다.
FormTriggerBuilder양식 트리거용 빌더입니다.
InstallationSource스크립트가 현재 사용자의 부가기능으로 설치되는 방식을 나타내는 열거형입니다.
ScriptApp스크립트 게시 및 트리거에 액세스하고 조작합니다.
Service스크립트 게시에 액세스하고 이를 조작합니다.
SpreadsheetTriggerBuilder스프레드시트 트리거용 빌더입니다.
StateTokenBuilder스크립트가 OAuth 흐름과 같은 콜백 API에 사용할 수 있는 상태 토큰을 만들도록 허용합니다.
Trigger스크립트 트리거
TriggerBuilder스크립트 트리거용 일반 빌더입니다.
TriggerSource트리거를 실행하는 이벤트의 소스를 나타내는 열거형입니다.

AuthMode

속성

속성유형설명
NONEEnum승인이 필요한 서비스에 대한 액세스를 허용하지 않는 모드입니다.
CUSTOM_FUNCTIONEnum커스텀 스프레드시트 함수에 사용할 제한된 서비스 하위 집합에 액세스할 수 있는 모드입니다.
LIMITEDEnum서비스의 제한된 하위 집합에 대한 액세스를 허용하는 모드입니다.
FULLEnum승인이 필요한 모든 서비스에 액세스를 허용하는 모드입니다.

AuthorizationInfo

방법

메서드반환 유형간략한 설명
getAuthorizationStatus()AuthorizationStatus사용자가 이 스크립트가 하나 이상의 서비스를 사용하도록 승인해야 하는지 여부를 나타내는 값을 가져옵니다 (예: ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()String스크립트에 대한 액세스 권한을 부여하는 데 사용할 수 있는 승인 URL을 가져옵니다.

AuthorizationStatus

속성

속성유형설명
REQUIREDEnum하나 이상의 서비스를 사용하려면 사용자가 이 스크립트를 승인해야 합니다.
NOT_REQUIREDEnum사용자가 이 스크립트에 현재 필요한 모든 승인을 부여했습니다.

CalendarTriggerBuilder

방법

메서드반환 유형간략한 설명
create()Trigger트리거를 만들어 반환합니다.
onEventUpdated()CalendarTriggerBuilder캘린더 항목이 생성, 업데이트 또는 삭제될 때 실행되는 트리거를 지정합니다.

ClockTriggerBuilder

방법

메서드반환 유형간략한 설명
after(durationMilliseconds)ClockTriggerBuilder트리거가 실행되는 현재 시간 이후의 최소 기간 (밀리초)을 지정합니다.
at(date)ClockTriggerBuilder트리거 실행 시점을 지정합니다.
atDate(year, month, day)ClockTriggerBuilder트리거가 지정된 날짜(기본적으로 자정 근처)에 실행되도록 지정합니다(+/- 15분).
atHour(hour)ClockTriggerBuilder트리거가 실행되는 시간을 지정합니다.
create()Trigger트리거를 만듭니다.
everyDays(n)ClockTriggerBuildern일마다 트리거를 실행하도록 지정합니다.
everyHours(n)ClockTriggerBuildern시간마다 트리거를 실행하도록 지정합니다.
everyMinutes(n)ClockTriggerBuildern분마다 트리거를 실행하도록 지정합니다.
everyWeeks(n)ClockTriggerBuildern주마다 트리거를 실행하도록 지정합니다.
inTimezone(timezone)ClockTriggerBuilder트리거가 실행될 때 지정된 날짜/시간의 시간대를 지정합니다.
nearMinute(minute)ClockTriggerBuilder트리거가 실행되는 분 (+ 또는 - 15분)을 지정합니다.
onMonthDay(day)ClockTriggerBuilder트리거가 실행되는 월의 날짜를 지정합니다.
onWeekDay(day)ClockTriggerBuilder트리거가 실행되는 요일을 지정합니다.

DocumentTriggerBuilder

방법

메서드반환 유형간략한 설명
create()Trigger새 트리거를 만들고 반환합니다.
onOpen()DocumentTriggerBuilder문서가 열릴 때 실행되는 트리거를 지정합니다.

EventType

속성

속성유형설명
CLOCKEnum시간 기반 이벤트가 특정 시간에 도달하면 트리거가 실행됩니다.
ON_OPENEnum사용자가 Google Docs, Sheets 또는 Forms 파일을 열면 트리거가 실행됩니다.
ON_EDITEnum사용자가 Google Sheets 파일을 수정하면 트리거가 실행됩니다 (예: 셀에 새 값을 입력하면 변경사항이 아닌 수정으로 계산됨).
ON_FORM_SUBMITEnum사용자가 Google 양식에 응답하면 트리거가 실행됩니다.
ON_CHANGEEnum사용자가 Google Sheets 파일을 변경하면 트리거가 실행됩니다 (예: 수정 대신 변경사항으로 집계되는 행 추가).
ON_EVENT_UPDATEDEnum지정된 Google 캘린더에서 이벤트가 생성, 업데이트 또는 삭제되면 트리거가 실행됩니다.

FormTriggerBuilder

방법

메서드반환 유형간략한 설명
create()Trigger새 트리거를 만들고 반환합니다.
onFormSubmit()FormTriggerBuilder양식에 응답을 제출할 때 실행될 트리거를 지정합니다.
onOpen()FormTriggerBuilder양식의 수정 뷰가 열릴 때 실행할 트리거를 지정합니다.

InstallationSource

속성

속성유형설명
APPS_MARKETPLACE_DOMAIN_ADD_ONEnum관리자가 사용자의 도메인에 부가기능을 설치했습니다.
NONEEnum스크립트가 부가기능으로 실행되고 있지 않습니다.
WEB_STORE_ADD_ONEnum사용자가 Chrome 웹 스토어에서 부가기능을 설치했습니다.

ScriptApp

속성

속성유형설명
AuthModeAuthMode트리거 함수를 통해 Apps Script가 실행할 수 있는 승인된 서비스의 카테고리를 식별하는 열거형입니다.
AuthorizationStatusAuthorizationStatus스크립트의 승인 상태를 나타내는 열거형입니다.
EventTypeEventType트리거된 이벤트의 유형을 나타내는 열거형입니다.
InstallationSourceInstallationSource스크립트가 사용자에게 부가기능으로 설치된 방법을 나타내는 열거형입니다.
TriggerSourceTriggerSource트리거를 실행하는 이벤트의 소스를 나타내는 열거형입니다.
WeekDayWeekday요일을 나타내는 열거형입니다.

방법

메서드반환 유형간략한 설명
deleteTrigger(trigger)void지정된 트리거를 삭제하여 더 이상 실행되지 않도록 합니다.
getAuthorizationInfo(authMode)AuthorizationInfo이 스크립트가 하나 이상의 서비스를 사용하기 위해 사용자가 이 스크립트를 승인해야 하는지 확인하고 승인 대화상자의 URL을 제공하는 데 사용되는 객체를 가져옵니다.
getIdentityToken()Stringopenid 범위가 부여된 경우 유효 사용자의 OpenID Connect ID 토큰을 가져옵니다.
getInstallationSource()InstallationSource스크립트가 현재 사용자의 부가기능으로 설치된 방법을 나타내는 열거형 값을 반환합니다 (예: 사용자가 Chrome 웹 스토어를 통해 스크립트를 개인적으로 설치했는지 또는 도메인 관리자가 모든 사용자에 대해 스크립트를 설치했는지 여부).
getOAuthToken()String유효 사용자의 OAuth 2.0 액세스 토큰을 가져옵니다.
getProjectTriggers()Trigger[]현재 프로젝트 및 현재 사용자와 연결된 설치 가능한 모든 트리거를 가져옵니다.
getScriptId()String스크립트 프로젝트의 고유 ID를 가져옵니다.
getService()Service스크립트를 웹 앱으로 게시하는 것을 제어하는 데 사용되는 객체를 가져옵니다.
getUserTriggers(document)Trigger[]이 스크립트 또는 부가기능에 대해 지정된 문서에서 이 사용자가 소유한 설치 가능한 모든 트리거를 가져옵니다.
getUserTriggers(form)Trigger[]이 스크립트 또는 부가기능에 한해 이 사용자가 소유한 설치 가능한 트리거를 지정된 형식으로 가져옵니다.
getUserTriggers(spreadsheet)Trigger[]이 스크립트 또는 부가기능에 한해 지정된 스프레드시트에서 이 사용자가 소유한 설치 가능한 모든 트리거를 가져옵니다.
invalidateAuth()void유효 사용자가 현재 스크립트를 실행하는 데 필요한 권한을 무효화합니다.
newStateToken()StateTokenBuilder콜백 API에서 사용할 수 있는 상태 토큰의 빌더를 만듭니다 (예: OAuth 흐름).
newTrigger(functionName)TriggerBuilder실행될 때 지정된 함수를 호출하는 설치 가능한 트리거를 만드는 프로세스를 시작합니다.

Service

방법

메서드반환 유형간략한 설명
getUrl()String웹 앱이 배포된 경우 URL을 반환하고 그렇지 않으면 null를 반환합니다.
isEnabled()Boolean스크립트에 웹 앱으로 액세스할 수 있는 경우 true를 반환합니다.

SpreadsheetTriggerBuilder

방법

메서드반환 유형간략한 설명
create()Trigger트리거를 만들어 반환합니다.
onChange()SpreadsheetTriggerBuilder스프레드시트의 콘텐츠나 구조가 변경될 때 실행되는 트리거를 지정합니다.
onEdit()SpreadsheetTriggerBuilder스프레드시트 수정 시 실행될 트리거를 지정합니다.
onFormSubmit()SpreadsheetTriggerBuilder스프레드시트에 제출된 양식이 있을 때 실행되는 트리거를 지정합니다.
onOpen()SpreadsheetTriggerBuilder스프레드시트가 열릴 때 실행될 트리거를 지정합니다.

StateTokenBuilder

방법

메서드반환 유형간략한 설명
createToken()String상태 토큰의 암호화된 문자열 표현을 생성합니다.
withArgument(name, value)StateTokenBuilder토큰에 인수를 추가합니다.
withMethod(method)StateTokenBuilder콜백 함수를 설정합니다.
withTimeout(seconds)StateTokenBuilder토큰이 유효한 기간 (초)을 설정합니다.

Trigger

방법

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

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를 만들고 반환합니다.

TriggerSource

속성

속성유형설명
SPREADSHEETSEnumGoogle Sheets에 의해 트리거가 실행됩니다.
CLOCKEnum시간 기반 이벤트로 인해 트리거가 실행됩니다.
FORMSEnumGoogle Forms를 사용하면 트리거가 실행됩니다.
DOCUMENTSEnumGoogle Docs에 의해 트리거가 실행됩니다.
CALENDAREnumGoogle Calendar에 의해 트리거가 실행됩니다.