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

Google Sheets 확장

Google Apps Script를 사용하면 Google 스프레드시트로 새롭고 멋진 작업을 할 수 있습니다. Apps Script를 사용하여 Google 스프레드시트에 커스텀 메뉴, 대화상자, 사이드바를 추가할 수 있습니다. 또한 Sheets용 커스텀 함수를 작성하고 Calendar, Drive, Gmail과 같은 다른 Google 서비스와 Sheets를 통합할 수 있습니다.

Google 스프레드시트용으로 설계된 대부분의 스크립트는 배열을 조작하여 스프레드시트의 셀, 행, 열과 상호작용합니다. 자바스크립트의 배열에 익숙하지 않다면 Codecademy에서 배열을 위한 훌륭한 학습 모듈을 제공합니다. (이 과정은 Google이 개발하지 않았으며 Google과 무관합니다.)

Google 스프레드시트에서 Apps Script를 사용하는 방법에 대한 간략한 소개는 매크로, 메뉴, 맞춤 함수에 대한 5분 빠른 시작 가이드를 참조하세요.

시작하기

Apps Script에는 Google Sheets를 프로그래매틱 방식으로 만들고 읽고 수정할 수 있는 특수 API가 포함되어 있습니다. Apps Script는 두 가지 방법으로 Google Sheets와 상호작용할 수 있습니다. 즉, 스크립트 사용자에게 스프레드시트에 대한 적절한 권한이 있으면 모든 스크립트가 스프레드시트를 만들거나 수정할 수 있습니다. 또한 스크립트는 스프레드시트에 바인딩될 수 있습니다. 따라서 스크립트는 사용자 인터페이스를 변경하거나 스프레드시트를 열 때 응답할 수 있는 특수한 기능을 제공합니다. 바인딩된 스크립트를 만들려면 Google Sheets 내에서 확장 프로그램 > Apps Script를 선택합니다.

스프레드시트 서비스는 Google 스프레드시트를 2차원 배열로 작동하는 그리드로 취급합니다. 스프레드시트에서 데이터를 검색하려면 데이터가 저장된 스프레드시트에 액세스하고 데이터가 저장된 스프레드시트의 범위를 가져온 후 셀 값을 가져와야 합니다. Apps Script는 스프레드시트의 구조화된 데이터를 읽고 이에 대한 JavaScript 객체를 만들어 데이터 액세스를 용이하게 합니다.

데이터 읽기

아래 이미지와 같이 스프레드시트에 제품 이름과 제품 번호의 목록이 저장된다고 가정해 보겠습니다.

아래 예시는 제품 이름과 제품 번호를 검색하고 로깅하는 방법을 보여줍니다.

function logProductInfo() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  for (var i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

로그 보기

로깅된 데이터를 보려면 스크립트 편집기의 맨 위에 있는 실행 로그를 클릭합니다.

데이터 쓰기

새 제품 이름 및 번호 등의 데이터를 스프레드시트에 저장하려면 스크립트 끝에 다음 코드를 추가합니다.

function addProduct() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

위의 코드는 지정된 값과 함께 새 행을 스프레드시트 하단에 추가합니다. 이 함수를 실행하면 스프레드시트에 추가된 새 행이 표시됩니다.

맞춤 메뉴 및 사용자 인터페이스

커스텀 메뉴, 대화상자, 사이드바를 추가하여 Google 스프레드시트를 맞춤설정할 수 있습니다. 메뉴 만들기의 기본사항을 알아보려면 메뉴 가이드를 참고하세요. 대화상자의 콘텐츠를 맞춤설정하는 방법을 알아보려면 HTML 서비스 가이드를 참고하세요.

스프레드시트 내 이미지나 그림에 스크립트 함수를 첨부할 수도 있습니다. 사용자가 이미지나 그림을 클릭하면 함수가 실행됩니다. 자세한 내용은 Google Sheets의 이미지 및 그림을 참고하세요.

부가기능의 일부로 맞춤 인터페이스를 게시하려면 스타일 가이드를 따라 Google Sheets 편집기의 스타일 및 레이아웃과 일관성을 유지하세요.

Google Forms에 연결하기

Apps Script를 사용하면 Forms 및 Sheets 서비스를 통해 Google Forms를 Google Sheets와 연결할 수 있습니다. 이 기능을 사용하면 스프레드시트의 데이터를 기반으로 Google 양식을 자동으로 만들 수 있습니다. Apps Script를 사용하면 사용자가 양식에 응답한 후 onFormSubmit와 같은 트리거를 사용하여 특정 작업을 수행할 수 있습니다. Google Sheets와 Google Forms를 연결하는 방법을 자세히 알아보려면 Google Forms의 응답 관리 5분 빠른 시작을 사용해 보세요.

형식 지정

Range 클래스에는 셀 또는 셀 범위의 형식에 액세스하고 수정하는 setBackground(color)와 같은 메서드가 있습니다. 다음 예는 범위의 글꼴 스타일을 설정하는 방법을 보여줍니다.

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

데이터 검증

Apps Script를 사용하면 Google 스프레드시트의 기존 데이터 유효성 검사 규칙에 액세스하거나 새 규칙을 만들 수 있습니다. 예를 들어 다음 샘플은 셀에 1부터 100 사이의 숫자만 허용하는 데이터 검증 규칙을 설정하는 방법을 보여줍니다.

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  var cell = SpreadsheetApp.getActive().getRange('B4');
  var rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

데이터 검증 규칙 작업에 관한 자세한 내용은 SpreadsheetApp.newDataValidation(), DataValidationBuilder, Range.setDataValidation(rule)를 참고하세요.

차트

Apps Script를 사용하면 스프레드시트에 특정 범위의 데이터를 나타내는 차트를 삽입할 수 있습니다. 다음 예시에서는 A1:B15 셀에 차트 작성 가능한 데이터가 있다고 가정하고 삽입된 막대 그래프를 생성합니다.

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
     .setChartType(Charts.ChartType.BAR)
     .addRange(sheet.getRange('A1:B15'))
     .setPosition(5, 5, 0, 0)
     .build();

  sheet.insertChart(chart);
}

스프레드시트에 차트를 삽입하는 방법에 대한 자세한 내용은 EmbeddedChart 및 특정 차트 빌더(예: EmbeddedPieChartBuilder)를 참고하세요.

Google Sheets의 맞춤 함수

커스텀 함수는 Apps Script로 함수의 동작을 정의한다는 점을 제외하면 =SUM(A1:A5)와 같은 기본 제공 스프레드시트 함수와 유사합니다. 예를 들어 값을 인치에서 밀리미터로 변환하는 맞춤 함수 in2mm()를 만든 다음 셀에 =in2mm(A1) 또는 =in2mm(10)를 입력하여 스프레드시트에서 수식을 사용할 수 있습니다.

커스텀 함수에 대한 자세한 내용은 메뉴 및 맞춤 함수(5분) 빠른 시작을 사용하거나 맞춤 함수에 대한 자세한 가이드를 참조하세요.

매크로

매크로는 Google 스프레드시트 UI에서 Apps Script 코드를 실행하는 또 다른 방법입니다. 맞춤 함수와 달리 단축키나 Google 스프레드시트 메뉴를 통해 이러한 함수를 활성화할 수 있습니다. 자세한 내용은 Google Sheets 매크로를 참고하세요.

Google Sheets용 부가기능

부가기능은 Google 스프레드시트 내에서 실행되고 Google 스프레드시트 부가기능 스토어에서 설치할 수 있는 특수 패키징된 Apps Script 프로젝트입니다. Google 스프레드시트용 스크립트를 개발했고 전 세계 사용자와 공유하려는 경우 Apps Script를 사용하면 스크립트를 부가기능으로 게시하여 다른 사용자가 부가기능 스토어에서 스크립트를 설치할 수 있습니다.

트리거

Google Sheets 파일에 결합된 스크립트는 onOpen() 및 onEdit() 함수와 같은 간단한 트리거를 사용하여 스프레드시트에 대한 수정 액세스 권한이 있는 사용자가 스프레드시트를 열거나 수정할 때 자동으로 응답할 수 있습니다.

간단한 트리거와 마찬가지로 설치 가능한 트리거를 사용하면 특정 이벤트가 발생할 때 Google 스프레드시트에서 함수를 자동으로 실행할 수 있습니다. 하지만 설치 가능한 트리거는 간단한 트리거보다 유연성이 뛰어나며 열기, 수정, 변경, 양식 제출, 시간 기반 (시계) 이벤트를 지원합니다.