이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Script Service

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

클래스

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

`AuthMode`

속성

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

`AuthorizationInfo`

방법

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

`AuthorizationStatus`

속성

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

`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)`	`ClockTriggerBuilder`	`n`일마다 트리거를 실행하도록 지정합니다.
`everyHours(n)`	`ClockTriggerBuilder`	`n`시간마다 트리거를 실행하도록 지정합니다.
`everyMinutes(n)`	`ClockTriggerBuilder`	`n`분마다 트리거를 실행하도록 지정합니다.
`everyWeeks(n)`	`ClockTriggerBuilder`	`n`주마다 트리거를 실행하도록 지정합니다.
`inTimezone(timezone)`	`ClockTriggerBuilder`	트리거가 실행될 때 지정된 날짜/시간의 시간대를 지정합니다.
`nearMinute(minute)`	`ClockTriggerBuilder`	트리거가 실행되는 분 (+ 또는 - 15분)을 지정합니다.
`onMonthDay(day)`	`ClockTriggerBuilder`	트리거가 실행되는 월의 날짜를 지정합니다.
`onWeekDay(day)`	`ClockTriggerBuilder`	트리거가 실행되는 요일을 지정합니다.

`DocumentTriggerBuilder`

방법

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

`EventType`

속성

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

`FormTriggerBuilder`

방법

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

`InstallationSource`

속성

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

`ScriptApp`

속성

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

방법

메서드	반환 유형	간략한 설명
`deleteTrigger(trigger)`	`void`	지정된 트리거를 삭제하여 더 이상 실행되지 않도록 합니다.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	이 스크립트가 하나 이상의 서비스를 사용하기 위해 사용자가 이 스크립트를 승인해야 하는지 확인하고 승인 대화상자의 URL을 제공하는 데 사용되는 객체를 가져옵니다.
`getIdentityToken()`	`String`	`openid` 범위가 부여된 경우 유효 사용자의 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`

속성

속성	유형	설명
`SPREADSHEETS`	`Enum`	Google Sheets에 의해 트리거가 실행됩니다.
`CLOCK`	`Enum`	시간 기반 이벤트로 인해 트리거가 실행됩니다.
`FORMS`	`Enum`	Google Forms를 사용하면 트리거가 실행됩니다.
`DOCUMENTS`	`Enum`	Google Docs에 의해 트리거가 실행됩니다.
`CALENDAR`	`Enum`	Google Calendar에 의해 트리거가 실행됩니다.

달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.

최종 업데이트: 2023-12-01(UTC)

블로그
Google Workspace 개발자 블로그 읽기
Stack Overflow
google-apps-script 태그를 사용한 질문
코드 샘플
코드 샘플을 살펴보거나 복사하여 직접 빌드하세요.
동영상
Apps Script 가이드 보기