Google Docs, Google Sheets, Google Analytics, Gmail 등 구글 서비스를 사용하고 있다면, 구글 앱스 스크립트(Google Apps Script)를 통해 이러한 서비스들을 서로 연결하고 자동화할 수 있습니다.
구글 앱스 스크립트는 마이크로소프트의 VBA 매크로를 구글 버전으로 만든 것이라고 생각하면 이해하기 쉽습니다. VBA로 워드나 엑셀에서 작업을 자동화하거나 매크로를 커스터마이징할 수 있는 것처럼, 앱스 스크립트를 활용하면 다양한 구글 서비스 전반에서 반복 작업과 업무 흐름을 자동으로 처리할 수 있습니다. 특히 Sheets나 Docs에서는 자신만의 커스텀 메뉴까지 만들 수 있습니다.
이 글에서는 여러 구글 서비스에서 앱스 스크립트에 접근하고 활성화하는 방법, 앱스 스크립트 에디터를 둘러보는 방법, 그리고 서비스 간 연동 방법까지 단계별로 살펴봅니다. 개별 스크립트 함수 문법은 다루지 않지만, 구글에서 제공하는 공식 문서와 튜토리얼이 매우 잘 정리되어 있으니 이를 참고하면 충분히 학습할 수 있습니다.
구글 앱스 스크립트 에디터에 접근하는 방법
앱스 스크립트 코드 에디터는 여러 구글 서비스 안에서 바로 열 수 있습니다. 예를 들어 Google Sheets에서는 확장 프로그램(Extensions) 메뉴에서 Apps Script 항목을 찾을 수 있습니다.
그 외 서비스에서는 아래 방법으로 앱스 스크립트 에디터를 열 수 있습니다.
- Google Docs: 도구(Tools) 메뉴에서 스크립트 편집기(Script editor) 선택
- Google Slides: 도구(Tools) 메뉴에서 스크립트 편집기(Script editor) 선택
- Google Forms: 오른쪽 상단 점 세 개(⋮) 메뉴에서 스크립트 편집기 선택
- Google Drive: 화면 빈 곳을 마우스 오른쪽 버튼으로 클릭한 후 더보기(More) → Google Apps Script 선택
어떤 방법을 사용하든 앱스 스크립트 코드 에디터가 새 탭에서 열립니다. 이 창에서 스크립트 전체를 구성하는 각 함수를 작성하게 됩니다. 기본적으로 비어 있는 myFunction() 함수가 미리 생성되어 있으므로, 바로 코드 작성을 시작할 수 있습니다.
참고: 오류를 방지하려면 코드 포맷팅이 매우 중요합니다. 아래 코드 예시처럼 주석을 활용해 각 코드 섹션의 의도를 기록해 두면 나중에 수정하거나 관리할 때 큰 도움이 됩니다. 이는 웹 프로그래밍에서 HTML 주석을 다루는 방식과 매우 유사합니다.
코드 에디터를 사용하는 동안 왼쪽 탐색 창의 Editor 화면에서 Code.gs 파일을 선택하면 언제든 코드 화면으로 돌아올 수 있습니다. 다른 화면을 보고 싶다면 맨 왼쪽 아이콘들 위에 마우스를 올리면 기본 탐색 창이 열립니다.
개요(Overview) 섹션에서는 스크립트 실행 통계를 확인할 수 있습니다. 발생한 오류 횟수, 총 실행 횟수 등의 정보가 여기에 표시됩니다.
에디터의 나머지 섹션들은 아래에서 하나씩 자세히 설명합니다.
구글 앱스 스크립트 에디터 살펴보기
에디터에서 코드를 수정할 때는 디스크(저장) 아이콘을 자주 눌러 작업 내용이 사라지지 않도록 하는 것이 좋습니다.
저장을 마치면 나머지 메뉴 옵션이 활성화됩니다.
주요 메뉴는 다음과 같습니다.
- 실행(Run): 스크립트 전체를 처음부터 끝까지 실행해 봅니다.
- 디버그(Debug): 스크립트를 한 줄씩 단계적으로 실행하며 문제를 추적합니다.
- 함수 드롭다운: 작성한 함수 목록을 탐색하고 원하는 함수로 바로 이동합니다.
- 실행 로그(Execution log): 스크립트를 실행할 때마다 출력된 상태 메시지나 오류 메시지를 확인합니다.
왼쪽 탐색 메뉴의 라이브러리(Libraries) 옵션에서는 다른 사람이 작성한 라이브러리(또는 본인이 따로 저장해 둔 라이브러리)를 가져올 수 있습니다. 예를 들어 지인이 이미 만들어 둔 Google Sheets나 Google Docs용 기능을 그대로 활용하면서, 거기에 추가 기능을 덧붙이고 싶을 때 매우 유용합니다.
라이브러리를 프로젝트에 추가하는 데 필요한 것은 스크립트 ID(Script ID)뿐입니다. 스크립트 ID는 프로젝트 설정 섹션에서 확인할 수 있으며, 찾는 방법은 이 글 마지막 부분에서 소개합니다.
구글 앱스 스크립트 서비스 애드온 연동
서비스(Services) 섹션은 가장 활용도가 높은 기능입니다. 현재 작성 중인 스크립트를 다른 구글 서비스와 통합할 수 있는 곳입니다.
선택하면 서비스 추가(Add a service) 창이 열립니다. 목록을 스크롤하여 프로젝트에 추가하고 싶은 서비스를 찾으세요.
예를 들어 Google Analytics 계정의 데이터를 스크립트로 불러오고 싶다면 Google Analytics API를 선택한 뒤 추가(Add) 버튼을 누르면 됩니다.
새로 추가한 서비스에서 어떤 함수를 사용할 수 있는지, 그리고 그 함수들의 사용법이 궁금하다면 API 이름 오른쪽의 점 세 개(⋮) 메뉴를 클릭하고 문서 보기(See documentation)를 선택하세요.
그러면 새 탭에서 구글 앱스 스크립트 공식 문서가 열리며, 해당 구글 서비스 섹션으로 자동으로 이동합니다.
공식 문서에는 함수 문법, 튜토리얼, 코드 예제가 정리되어 있으니 직접 스크립트를 작성할 때 적극적으로 활용해 보세요.
또한 문서의 다른 섹션을 둘러보면, 앱스 스크립트 에디터를 처음 연 서비스를 기준으로 어떤 일반 함수들을 사용할 수 있는지도 확인할 수 있습니다.
예를 들어 Google Sheets에서 에디터를 열었다면, 문서 메뉴의 Sheets 섹션에서 해당 스크립트에서 사용 가능한 Google Sheets 전용 함수들을 살펴볼 수 있습니다.
앱스 스크립트 트리거 설정 및 활용
구글 앱스 스크립트의 또 다른 강력한 기능은 다양한 이벤트나 일정에 따라 트리거(Trigger)를 설정할 수 있다는 점입니다.
스크립트에 새 트리거를 추가하려면 맨 왼쪽 탐색 메뉴에서 트리거(Triggers)를 선택하세요. 새로 열리는 트리거 창에서 트리거 추가(Add Trigger) 버튼을 클릭합니다.
트리거 추가 창에는 스크립트가 언제, 어떻게 실행될지 세밀하게 조정할 수 있는 다양한 옵션이 있습니다.
참고: 이 옵션들은 스크립트를 작성하는 대상 서비스나 추가한 API에 따라 달라집니다.
트리거를 설정하려면 다음 항목들을 선택해야 합니다.
- 처음 실행할 함수 선택
- 이벤트 소스(Event source): 특정 시간·날짜 또는 서비스 내 이벤트(예: 스프레드시트 셀이 변경될 때, 문서가 처음 열릴 때)
- 이벤트 유형(Event type): 스프레드시트나 문서가 열리거나 편집될 때 등 구체적인 조건, 또는 날짜·시간 관련 세부 설정
- 알림 빈도(Notification frequency): 스크립트 실행 실패 시 얼마나 자주 알림을 받을지 설정
저장(Save)을 눌렀을 때 처음이라면 "스크립트 인증 실패(Script authorization failed)"라는 메시지가 나타날 수 있습니다.
이는 대부분 브라우저에서 팝업 차단 기능이 켜져 있기 때문입니다. Chrome을 사용한다면 주소창 근처의 빨간 "X"가 표시된 작은 창 아이콘을 클릭하고, 설정을 항상 팝업 허용(Always allow pop-ups)으로 변경한 뒤 완료(Done)를 누르세요.
다시 저장을 누르면, 작성한 스크립트가 본인의 구글 계정 또는 Google Workspace 환경에서 실행되도록 허용하는 인증 절차를 진행하게 됩니다.
먼저 스크립트 실행을 허용할 구글 계정을 선택합니다.
이후 "직접 작성한 커스텀 함수나 스크립트가 구글의 공식 인증(검증)을 받지 않았다"는 경고가 표시됩니다. 하지만 스크립트를 직접 작성한 본인이라면 이 경고는 문제가 되지 않으며, 자신의 계정 환경에서 안전하게 실행할 수 있습니다.
이 경고를 건너뛰려면 고급(Advanced)을 클릭한 후 하단의 <프로젝트>(으)로 이동(안전하지 않음) 링크를 선택하세요.
마지막으로 권한 요청 창에서 허용(Allow)을 누르면 커스텀 함수와 스크립트가 본인의 구글 계정 또는 Google Workspace에서 실행될 수 있습니다.
이 인증 과정은 최초 한 번만 진행하면 되며, 이후에는 같은 절차를 반복할 필요가 없습니다.
내 구글 스크립트 ID 확인하기
마지막으로 알아둘 점 하나. 작성한 스크립트를 친구나 동료에게 공유하거나, 다른 사람이 자신의 스크립트에 라이브러리로 추가하도록 하려면 스크립트 ID가 필요합니다.
스크립트 ID는 맨 왼쪽 탐색 창의 설정(톱니바퀴) 아이콘에서 확인할 수 있습니다.
설정 화면의 ID 섹션에서 Script ID 항목 오른쪽에 표시된 값이 바로 스크립트 ID입니다.
지금까지 살펴본 것처럼, 구글 앱스 스크립트 에디터는 각 기능의 위치만 익혀두면 생각보다 훨씬 쉽게 사용할 수 있습니다. 구글의 앱스 스크립트 공식 문서를 꼼꼼히 학습하면서 스크립트 작성법과 사용 가능한 다양한 함수들을 익혀 나가시길 바랍니다.