Google Apps Script는 사용자 데이터, 기타 Google 시스템 및 외부 시스템과 상호작용하는 30개 이상의 기본 서비스를 제공합니다. 이러한 서비스는 자바스크립트의 표준 Math
객체와 유사한 전역 객체로 제공됩니다. 예를 들어 Math
이 random()
와 같은 메서드와 PI
와 같은 상수를 제공하는 것처럼 Apps Scripts의 스프레드시트 서비스는 openById(id)
와 같은 메서드, 클래스 (하위 객체), Range
와 DataValidationCriteria
와 같은 열거형을 제공합니다.
Google Workspace 제품을 제어하는 서비스에 대한 참조 문서는 이 사이트의 사이드바에 있는 '참조' 헤더의 'Google Workspace 서비스' 섹션에 수집되어 있습니다. 사용자 서비스 생성, XML 파싱, 로그 데이터 쓰기와 같은 유틸리티 서비스는 '스크립트 서비스' 섹션에 수집됩니다.
최신 자바스크립트 기능
Apps Script는 2가지 자바스크립트 런타임, 즉 최신 V8 런타임과 Mozilla의 Rhino 자바스크립트 인터프리터를 기반으로 하는 이전 런타임을 지원합니다.
V8 런타임은 최신 ECMAScript 구문 및 기능을 지원합니다. Rhino 런타임은 이전 자바스크립트 1.6 표준 및 1.7 및 1.8의 몇 가지 기능을 기반으로 합니다. 스크립트에 사용할 런타임을 자유롭게 선택할 수 있지만 V8 런타임을 사용하는 것이 좋습니다.
각 런타임은 기본 제공 고급 Google 서비스 외에도 스크립트에 사용할 수 있는 자바스크립트 클래스 및 객체를 지원합니다. 이 스크립트는 Array
, Date
, RegExp
, 등과 같은 일반 객체와 Math
및 Object
전역 객체를 사용할 수 있습니다.
자동 완성 사용
스크립트 편집기는 '콘텐츠 지원' 기능(더 일반적으로는 '자동 완성'이라고 함)을 제공합니다. 이 기능은 스크립트의 현재 컨텍스트에서 유효한 메서드와 열거형뿐만 아니라 전역 객체를 표시합니다. Apps Script 클래스를 반환하는 전역 객체, enum, 메서드 호출 뒤에 마침표를 입력할 때마다 자동 완성 추천이 자동으로 표시됩니다. 예를 들면 다음과 같습니다.
- 전역 객체의 전체 이름을 입력하거나 자동 완성에서 객체 하나를 선택한 다음
.
(마침표)를 입력하면 해당 클래스의 모든 메서드와 열거형이 표시됩니다. - 몇 글자를 입력하면 입력한 문자로 시작하는 유효한 모든 추천이 표시됩니다.
전역 객체 이해
각 서비스는 하나 이상의 전역 (최상위) 객체를 제공합니다. 예를 들어 Gmail 서비스는 GmailApp
객체에서만 액세스합니다. 일부 서비스는 여러 전역 객체를 제공합니다. 예를 들어 기본 서비스에는 Browser
, Logger
, MimeType
, Session
의 4가지 전역 객체가 포함됩니다.
호출 메서드
거의 모든 기본 제공 또는 고급 서비스의 전역 객체에는 데이터 또는 Apps Script 클래스를 반환하는 메서드가 포함됩니다. 스크립트는 다음 형식으로 메서드 호출을 호출합니다.
GlobalObjectName.methodName(argument1, argument2, ..., argumentN);
예를 들어 스크립트는 다음과 같이 Gmail 서비스의 sendEmail(recipient, subject, body)
메서드를 호출하여 이메일을 보낼 수 있습니다.
GmailApp.sendEmail('claire@example.com', 'Subject line', 'This is the body.');
메서드가 다른 Apps Script 클래스를 반환하면 한 줄에 메서드 호출을 연결할 수 있습니다. 반환 유형은 자동 완성과 메서드의 참조 문서에 모두 표시됩니다. 예를 들어 DocumentApp.create()
메서드는 Document
를 반환합니다. 따라서 다음 코드 섹션 두 개는 동일합니다.
var doc = DocumentApp.create('New document');
var body = doc.getBody();
body.appendParagraph('New paragraph.');
// Same result as above.
DocumentApp.create('New document').getBody().appendParagraph('New paragraph.');
하위 클래스 액세스
모든 서비스에는 전역 객체와 같이 최상위 수준에서 액세스할 수 없는 하나 이상의 하위 클래스가 포함되어 있습니다. Date
와 같은 표준 자바스크립트 클래스와 마찬가지로 new
키워드를 사용하여 이러한 클래스를 구성할 수 없습니다. 하위 클래스를 반환하는 메서드를 호출해야만 하위 클래스에 액세스할 수 있습니다. 특정 클래스에 액세스하는 방법을 모르는 경우 서비스의 참조 페이지를 방문하여 원하는 클래스를 반환하는 메서드를 찾아보세요.
인터페이스 처리
참조 서비스에는 '인터페이스'로 라벨이 지정된 특수 클래스가 있습니다. 다음은 정확한 유형을 미리 결정할 수 없는 메서드의 반환 유형으로 사용되는 일반 클래스입니다. 예를 들어 Document service 메서드 Body.getChild(childIndex)
는 일반 Element
객체를 반환합니다.
Element
는 다른 클래스(Paragraph
또는 Table
일 수 있음)를 나타내는 인터페이스입니다. 인터페이스 객체는 자체적으로 유용한 경우가 거의 없습니다. 대신 Element.asParagraph()
와 같은 메서드를 호출하여 객체를 정확한 클래스로 다시 변환하는 것이 좋습니다.
Enum 작업
대부분의 서비스는 이름이 지정된 일부 열거형 (열거형)을 포함합니다. 예를 들어 Drive 서비스는 열거형 Access
및 Permission
를 사용하여 파일 또는 폴더에 액세스할 수 있는 사용자를 결정합니다. 대부분의 경우 전역 객체에서 이러한 enum에 액세스합니다. 예를 들어 Folder.setSharing(accessType, permissionType)
메서드를 호출하면 다음과 같습니다.
// Creates a folder that anyone on the Internet can read from and write to. (Domain administrators can
// prohibit this setting for Google Workspace users.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);