Gemini가 코드를 작성하는 시대, Google Apps Script 사용법
코딩 없이 Google Apps Script를 사용하는 방법을 알아보세요. 이제 Apps Script에서 Gemini를 정식으로 사용할 수 있습니다. 지원 요금제, 설정 방법, 첫 스크립트 작성, 제한 사항 및 대안까지 모두 확인해 보세요.

Google Sheets, Docs, Slides, Forms의 ‘확장 프로그램’ 메뉴에는 코드 편집기가 숨겨져 있습니다. 대부분의 사람들은 한 번 열어보고는 바로 닫아버리곤 하죠. JavaScript를 직접 작성해야 한다는 부담감 때문에 Google Apps Script 사용법을 배우지 못했다면, 이제 그 장벽이 완전히 무너졌습니다.
간단히 말해, ’확장 프로그램’에서 ’Apps Script’를 클릭하고 Gemini 사이드 패널에 원하는 작업을 설명하기만 하면 됩니다. 제안된 코드를 검토한 후 저장하고 실행하세요. Google은 2026년 11월 16일에 Business Standard 이상 요금제와 Google AI Pro 및 Ultra 사용자를 대상으로 이 사이드 패널을 정식 출시(GA)했다고 발표했습니다.
이 가이드에서는 첫 스크립트를 작성하는 방법, 시작하기 좋은 프롬프트, Google의 제한 사항, 그리고 패널이 지원되지 않는 요금제에서의 대안을 살펴봅니다. 마지막 대안으로 소개할 GPT Workspace는 Sheets, Docs, Slides, Gmail 내에서 ChatGPT, Claude, Gemini를 바로 사용할 수 있게 해주는 Chrome 확장 프로그램이자 Google Workspace 부가기능입니다.
무엇이 달라졌을까요: Apps Script 내 Gemini 정식 출시
Apps Script는 Workspace에 내장된 자동화 도구입니다. Google의 Apps Script 개요에 따르면, 별도의 설치 없이 브라우저 편집기에서 JavaScript를 작성할 수 있으며 작성된 스크립트는 Google Drive에 저장되어 Google 서버에서 실행됩니다.
문제는 항상 JavaScript였습니다. 하지만 2026년 11월 16일자 Google의 Workspace Updates 게시물에서 이 문제가 해결되었습니다. 사이드 패널이 정식 출시되면서 이제 누구나 “코딩 경험 없이도 일상적인 언어를 사용해 스크립트를 만들고, 맞춤설정하고, 문제를 해결”할 수 있게 되었습니다.
이 패널은 크게 세 가지 역할을 합니다.
| 역할 | Gemini의 기능 | 실행 위치 |
|---|---|---|
| 작성 | 일상 언어로 된 요청을 스크립트로 변환하고, 요청 시 시간 기반 트리거 등의 추가 기능을 더해줍니다. | Gemini 사이드 패널 |
| 검토 | 제안된 변경 사항을 블록 단위로 보여주어, 저장 전에 수락하거나 거부할 수 있습니다. | 코드 편집기 |
| 수정 | 런타임 오류를 쉬운 언어로 설명하고 바로 적용할 수 있는 수정안을 제안합니다. | 실행 로그 |
지원 대상
- 지원 요금제: Business Standard 및 Plus, Enterprise Standard 및 Plus, AI Expanded Access 부가기능, 교육용 Google AI Pro, 일반 사용자용 Google AI Pro 및 Ultra.
- 지원 제외: Business Starter 및 무료 개인 계정.
- 출시 일정: 2026년 11월 12일부터 빠른 출시(Rapid Release) 및 계획된 출시(Scheduled Release) 도메인에 순차적으로 적용되며, 패널이 표시되기까지 최대 15일이 소요될 수 있습니다.
- 권한: 스크립트는 “사용자의 기존 권한과 표준 OAuth 동의”를 바탕으로 실행되므로, 현재 계정에서 접근할 수 있는 데이터만 다룰 수 있습니다.
- 관리자 설정: Google에 따르면 이 패널은 “기존 Apps Script 서비스 설정”과 관리 콘솔의 생성형 AI 액세스 제어 정책을 준수합니다.
아직 업데이트되지 않은 개발자 가이드
Google의 Gemini 사이드 패널 개발자 가이드는 2026년 9월 3일에 마지막으로 업데이트되었으며, 11월 16일 기준으로 여전히 베타 버전 안내가 포함되어 있습니다. 해당 가이드에는 제안을 전체적으로 수락하거나 거부해야 하며, Gemini가 활성화된 파일에서만 작동한다고 명시되어 있습니다.
하지만 정식 출시 게시물에서는 블록 단위의 검토가 가능하며, Gemini가 “열려 있는 Apps Script 프로젝트 전체의 파일을 이해한다”고 설명합니다. 만약 편집기에 ’모두 수락’과 ‘모두 거부’ 옵션만 보인다면, 아직 이전 버전을 사용 중인 것일 수 있습니다. 전체 배포에는 최대 15일이 걸리기 때문입니다.
Gemini와 함께하는 Google Apps Script 사용법: 첫 스크립트 작성하기
아래 예시는 스프레드시트에서 영업 수수료를 계산하는 맞춤 함수를 만드는 Google의 출시 데모입니다.
- 편집기 열기. Google Sheets에서 ’확장 프로그램’을 클릭한 다음 ’Apps Script’를 선택합니다. 특정 파일에 종속되지 않은 스크립트를 작성하려면 브라우저 주소창에 script.new를 입력하세요.
- Gemini 패널 열기. Google에 따르면 “새 스크립트에서는 자동으로 열립니다.” 기존 프로젝트의 경우, 편집기 우측 상단에 있는 반짝이 모양의 ‘Ask Gemini’ 아이콘을 클릭하세요.
- 작업 설명하기. 입력값, 규칙, 출력값을 명확히 지정합니다. Google 데모의 프롬프트는 다음과 같습니다. “COMMISSION(amount, region) 맞춤 함수를 만들어줘. 요율은 NA 8%, EMEA 7%, APAC 7.5%, LATAM 9%야. 10만 달러 이상의 거래에는 1%를 추가해줘.”
- 제안 검토하기. 편집기에 새 코드가 표시되며, 추가된 부분은 녹색으로, 삭제된 부분은 빨간색으로 나타납니다. 각 블록에서 수락(Accept) 또는 거부(Reject)를 클릭하거나, 사이드 패널에서 모두 수락(Accept all) 및 모두 거부(Reject all)를 사용할 수 있습니다.
- 프로젝트 저장하기. 편집기 도구 모음에서 ‘프로젝트 저장(Save project)’ 아이콘을 클릭합니다.
- 사용하기. 스프레드시트로 돌아가 기본 제공 함수처럼
=COMMISSION(E2, A2)를 입력합니다. 입력하는 동안 Gemini가 작성한 설명이 도움말 텍스트로 표시됩니다.
맞춤 함수는 가장 가볍게 시작하기 좋은 첫 프로젝트입니다. Google의 맞춤 함수 가이드에 따르면 맞춤 함수는 “사용자에게 개인 데이터 접근 권한을 요구하지 않습니다.”
하지만 Gmail을 읽거나 이메일을 보내는 스크립트는 다릅니다. 처음 실행할 때 Google 권한 요청 창이 열리며, 개발자 가이드에서는 “허용을 클릭하기 전에 요청된 권한을 검토하라”고 권장합니다.
Google Apps Script 예시: 시작하기 좋은 프롬프트
프롬프트는 스크립트 실행 시점, 읽어올 데이터, 결과가 저장될 위치라는 세 가지 요소를 명확히 할 때 가장 잘 작동합니다. 다음 예시들을 참고해 보세요.
| 작업 | 프롬프트 | 출처 |
|---|---|---|
| 맞춤 함수 | “ID별로 열을 그룹화하고, 최대 금액을 계산하며, 고유한 상태를 나열하는 CONSOLIDATE_DATA 맞춤 함수를 만들어줘.” | Google 개발자 가이드 |
| Gmail을 Tasks로 | “최근 30일 동안 제목에 ’URGENT’가 포함된 읽지 않은 이메일을 Gmail 받은편지함에서 검색하고, 이를 Google Tasks에 추가하는 스크립트를 작성해줘.” | Google 개발자 가이드 |
| Sheets를 Docs로 | “표 내용을 새 Google Docs로 내보내고 사용자에게 경로를 메시지로 알려주는 ’Export to Docs’라는 맞춤 메뉴를 Google Sheets에 만들어줘.” | Google 개발자 가이드 |
| 주간 보고서 | “매주 월요일 오전 8시에 Sales 탭에서 상태가 ’Overdue(기한 초과)’인 행을 이메일로 보내줘.” | 자체 제작 예시 |
스크립트 예약 실행하기
트리거가 무엇인지 몰라도 괜찮습니다. 출시 게시물에 따르면 “계속 대화하면서 자동 시간 기반 트리거와 같은 기능을 추가”할 수 있습니다.
Google의 설치 가능한 트리거 가이드를 보면, 시간 기반 트리거는 “최소 1분 단위부터 최대 한 달 단위까지” 실행 주기를 설정할 수 있습니다.
여기서 사람들이 자주 놀라는 두 가지 사실이 있습니다. 매일 오전 9시 반복 트리거를 설정하면 Apps Script가 오전 9시에서 10시 사이의 임의의 시간에 실행한다는 점, 그리고 트리거는 항상 그것을 만든 사람의 계정 권한으로 실행된다는 점입니다.
기존 스크립트 수정하기
코드를 수정할 때는 이름을 명시하여 지정하세요. 개발자 가이드에서는 “작업 중인 파일의 기존 함수나 변수를 명시적으로 참조하라”고 안내합니다.
스크립트에 오류가 발생했을 때: 오류 수정 및 알아두어야 할 제한 사항
Gemini가 작성한 스크립트라도 오류가 발생할 수 있습니다. 실행 중 오류로 멈추면 실행 로그(Execution log)에 ‘오류 수정(Fix errors)’ 버튼이 나타납니다.
- 함수를 실행하고 실행 로그에 빨간색 오류 줄이 나타날 때까지 기다립니다.
- ’오류 수정’을 클릭합니다. Gemini가 오류와 그 주변 코드를 분석합니다.
- 설명을 읽고 제안된 수정 사항을 수락하거나 거부합니다.
- 저장 후 다시 실행하여 오류가 해결되었는지 확인합니다.
Google의 데모에서는 Gmail을 캘린더로 연동하는 스크립트가 “TypeError: thread.getSubject is not a function”이라는 메시지와 함께 실패했습니다. 이에 대해 Gemini는 Gmail 스레드에는 해당 메서드가 없다고 설명하며, 대신 가장 최근 메시지에서 제목을 읽어오도록 수정안을 제시했습니다.
어떤 문제는 아예 오류 메시지를 띄우지 않기도 합니다. 이럴 때 개발자 가이드에서는 “스크립트에서 오류가 발생하지는 않지만 출력 결과가 잘못되었어”와 같이 일상적인 언어로 프롬프트를 작성해 보라고 권장합니다.
스크립트 실행을 제한하는 할당량
코드는 Gemini가 작성하지만, 스크립트의 실행 시간과 빈도는 여전히 Google 서버의 제한을 받습니다. 아래 수치들은 Google의 Apps Script 할당량 페이지를 참고했습니다.
| 제한 항목 | 일반 계정 (gmail.com) | Google Workspace 계정 |
|---|---|---|
| 스크립트 실행 시간 | 실행당 6분 | 실행당 6분 |
| 맞춤 함수 실행 시간 | 실행당 30초 | 실행당 30초 |
| 트리거 | 스크립트당 사용자별 20개 | 스크립트당 사용자별 20개 |
| 총 트리거 실행 시간 | 하루 90분 | 하루 6시간 |
| 이메일 수신자 | 하루 100명 | 하루 1,500명 |
스크립트가 제한을 초과하면 예외 오류를 발생시키고 중단됩니다. Google은 이러한 할당량이 사전 예고 없이 언제든 변경될 수 있다고 덧붙입니다.
맞춤 함수에는 한 가지 규칙이 더 있습니다. Google 가이드에 따르면 맞춤 함수는 “값을 반환하는 셀 이외의 다른 셀에는 영향을 미칠 수 없습니다.” 따라서 전체 범위를 수정해야 할 때는 Gemini에게 맞춤 메뉴 항목을 만들어 달라고 요청하는 것이 좋습니다.
패널 자체의 한계
개발자 가이드에는 몇 가지 제한 사항이 더 나열되어 있으며, 편집기에서 직접 확인해 볼 만한 내용들입니다.
- 언어: 현재 영어만 지원됩니다.
- 계정: 동일한 브라우저 세션에 여러 Google 계정이 로그인되어 있으면 패널이 로드되지 않을 수 있습니다.
- 접근 권한: Gemini는 본인이 소유하거나 수정 권한이 있는 스크립트 프로젝트에서만 작동합니다.
- 링크: Gemini는 “생성된 코드에서 URL을 누락하는 경우가 종종 있으므로” 프롬프트에 정확한 URL을 붙여넣는 것이 좋습니다.
Gemini 요금제가 아니신가요? GPT Workspace 활용하기
Apps Script 자체는 요금제에 제한을 받지 않습니다. Google의 할당량 표에서 알 수 있듯 일반 gmail.com 계정도 포함되므로, Business Standard 미만의 요금제에서도 편집기를 충분히 사용할 수 있습니다.
이러한 계정에 부족한 것은 바로 AI 어시스턴트입니다. GPT Workspace는 편집기가 아닌 스프레드시트 내에서 바로 이 빈자리를 채워줍니다.
- 스프레드시트에서 GPT Workspace 사이드바를 열고 ChatGPT, Claude, Gemini 중 원하는 모델을 선택합니다.
- Gemini에게 하듯 실행 일정, 데이터, 출력값을 명시하여 스크립트를 요청합니다.
- 확장 프로그램의 Apps Script 편집기에 코드를 붙여넣고 저장합니다.
- 실행에 실패하면 오류 메시지를 사이드바에 다시 붙여넣고 수정을 요청합니다.

스크린샷이 아닌 일러스트레이션: Sheets의 GPT Workspace 사이드바에 입력할 수 있는 요청 예시입니다. Gemini 프롬프트에 필요한 세 가지 요소인 일정, 데이터, 출력값을 모두 포함하고 있습니다.
Google Docs, Sheets, Slides, Gmail, Drive 내에서 탭 전환 없이 ChatGPT, Claude, Gemini를 바로 사용해 보세요.
무료로 시작하기때로는 스크립트를 아예 사용하지 않는 것이 더 나은 해결책일 수 있습니다.
| 원하는 작업 | 가장 빠른 방법 |
|---|---|
| 지원되는 Google 요금제에서의 반복 작업 | Apps Script 내 Gemini |
| Business Starter 또는 무료 Gmail에서의 동일한 작업 | GPT Workspace로 스크립트를 작성한 후 Apps Script에 붙여넣기 |
| 모든 행에 AI 적용: 라벨링, 번역, 검색 | =GPT, =GPT_CLASSIFY, =GPT_TRANSLATE, =GPT_WEB 등의 GPT Workspace 함수 사용 |
| 일회성 데이터 정리 또는 요약 | 선택한 범위에 대해 GPT Workspace 사이드바에서 프롬프트 실행 |
행마다 개별적인 판단이 필요한 작업이라면 스크립트보다 함수가 훨씬 유리합니다. Google Sheets에서 AI를 사용하는 방법 가이드에서 사이드바 활용법을 다루고 있으며, =GPT_CLASSIFY 튜토리얼에서는 고정된 라벨로 Google Sheets에서 데이터를 분류하는 방법을 확인할 수 있습니다.
Gemini의 장점: 편집기 내에 내장되어 있고, 검토 가능한 형태로 변경 사항을 제안하며, 로그에서 바로 오류를 수정할 수 있습니다. 요금제에 포함되어 있다면 트리거로 실행되는 모든 작업에 활용해 보세요.
GPT Workspace의 장점: Gemini 요금제가 필요 없고, 원하는 AI 모델을 선택할 수 있으며, 전용 함수를 통해 편집기를 아예 거치지 않아도 됩니다. 사용량 제한이 있는 무료 요금제를 제공하며, 유료 요금제에서는 이 제한이 늘어납니다.
스크립트 작성을 위해 어떤 모델을 선택해야 할지 고민되시나요? Claude와 ChatGPT 사용 시기 비교 가이드에서 실제 Workspace 작업 환경을 기준으로 두 모델을 비교해 두었으니 참고해 보세요.

스크린샷이 아닌 일러스트레이션: 이 섹션의 네 가지 핵심 포인트를 하나의 목록으로 정리했습니다. 직장이나 학교 계정의 경우, 설치 가능한 부가기능은 관리자가 결정합니다.
자주 묻는 질문 (FAQ)
마무리하며
예전에는 Google Apps Script 사용법을 배우려면 JavaScript 강의부터 들어야 했습니다. 하지만 이제는 단 한 문장이면 충분합니다. 확장 프로그램을 열고, Apps Script를 클릭한 다음, Gemini에게 원하는 것을 말하고, 각 코드 블록을 검토하며, 할당량만 잘 체크하면 됩니다.
만약 사용 중인 요금제에서 패널을 지원하지 않거나, 행마다 개별적인 AI 응답이 필요한 작업이라면 스프레드시트 내에서 GPT Workspace를 활용해 보세요. 설치 후 첫 스크립트나 함수를 요청해 보고, 어떤 방법이 더 효율적인지 직접 확인해 보시기 바랍니다.