앱스스크립트 Gemini 사이드 패널 사용법: 오류 났을 때 'Fix with Gemini'로 고치는 순서와 프롬프트 예시
- 구글 앱스스크립트 편집기 오른쪽 패널에 Gemini가 들어와 코드 작성, 수정, 오류 디버깅을 도와줍니다.
- 실행 로그에서 'Fix with Gemini' 버튼을 누르면 원인 설명과 수정안(diff)을 한 번에 받습니다.
- 다만 라이선스 조건, 영어 전용, 부분 수락 불가 같은 제한이 있어 쓰기 전에 확인할 점이 있습니다.
구글 시트나 구글폼에 자동화를 붙일 때 가장 막막한 순간은 빨간 오류 메시지가 뜰 때입니다. 이 글은 앱스스크립트 편집기에 들어온 Gemini 사이드 패널로 코드를 만들고 오류를 고치는 순서와, 바로 복사해 쓸 수 있는 프롬프트 예시를 정리한 가이드입니다. 기준 시점은 2026년 10월 22일이며, 구글 공식 문서의 내용을 바탕으로 썼습니다.
먼저 밝혀 둘 점이 있습니다. 저는 이 글을 쓰면서 사이드 패널을 직접 실행해 보지 못했습니다. 아래의 기능 설명은 구글 개발자 문서와 Workspace 도움말에서 확인한 내용이고, 프롬프트와 활용 장면은 제가 정리한 예시 틀입니다. 실제 화면과 결과는 계정 종류와 설정에 따라 다를 수 있습니다.
1. 앱스스크립트에 Gemini가 들어온 이유
앱스스크립트는 구글 시트, 문서, 폼, Gmail을 자바스크립트 기반으로 자동화하는 도구입니다. 코딩을 배우지 않은 직장인도 AI에게 코드를 받아 붙여 넣는 방식으로 많이 씁니다. 지금까지는 ChatGPT나 Claude 같은 외부 AI에 코드를 복사해 물어보고, 답을 다시 편집기에 붙여 넣는 왕복이 필요했습니다.
구글 문서에 따르면 편집기 오른쪽 사이드 패널의 Gemini는 현재 열려 있는 스크립트 프로젝트의 저장된 내용을 맥락으로 삼아 코드와 설명을 제공합니다. 즉 화면을 오가며 코드를 복사하는 수고가 줄어듭니다. Workspace 관리자용 도움말 페이지에는 이 기능이 2026년 8월 3일 항목으로 Gemini 베타 기능 목록에 올라 있습니다.
2. 쓰기 전에 확인할 조건 4가지
모든 사람이 바로 쓸 수 있는 기능은 아닙니다. 공식 문서가 밝힌 조건을 표로 정리했습니다.
| 항목 | 공식 문서 내용 | 내가 확인할 것 |
|---|---|---|
| 라이선스 | Workspace Business Standard/Plus, Enterprise Standard/Plus, Gemini 애드온, Google AI Pro for Education, Google AI Pro, Google AI Ultra 중 하나 | 내 계정이 위 중 어디에 해당하는지 |
| 관리자 설정 | Workspace 도메인 관리자가 관리 콘솔에서 Gemini(생성형 AI) 기능을 켜야 함 | 회사 계정이라면 관리자에게 문의 |
| 계정 로그인 | 여러 구글 계정에 동시에 로그인하면 패널이 안 뜰 수 있음 | 단일 계정 프로필 또는 시크릿 창에서 열기 |
| 언어 | 영어만 지원 | 한국어로 물어보면 기대와 다를 수 있으니 영어 프롬프트 준비 |
회사 계정이라면 관리자가 기능을 꺼 두었을 수 있습니다. 패널 아이콘이 보이지 않는다면 코드가 아니라 계정과 설정 문제일 가능성이 큽니다. 개인 계정은 Google AI Pro 또는 Ultra 구독이 필요하다고 문서에 나와 있습니다.
3. 패널 여는 법과 기본 사용 순서
공식 문서의 순서는 다음과 같습니다.
- script.google.com에서 프로젝트를 열거나 script.new로 새 프로젝트를 만듭니다. 시트, 문서, 슬라이드, 폼에서 확장 프로그램 메뉴의 Apps Script를 눌러 열어도 됩니다.
- 오른쪽 패널 메뉴의 Gemini(반짝이) 아이콘을 누릅니다.
- 아래 입력창에 요청을 쓰고 Enter를 누릅니다.
- 제안된 코드는 편집기에 변경점 보기(Diff View)로 나타납니다. 추가된 줄과 삭제된 줄이 표시됩니다.
- 'Accept All'로 모두 적용하거나 'Reject All'로 모두 취소합니다.
중요한 제한은 일부만 골라 수락할 수 없다는 점입니다. 제안이 길면 한 줄이 마음에 들지 않아도 전부 받거나 전부 버려야 합니다. 그래서 적용 전에 원본 파일을 복사해 두는 습관이 안전합니다. 구글 앱스스크립트에는 버전 기능이 있으니 큰 수정 전에는 버전을 저장해 두는 것도 방법입니다.
4. 코드 만들기와 고치기: 프롬프트 예시
공식 문서가 예시로 든 요청은 사용자 지정 함수 만들기, Gmail에서 긴급 메일을 찾아 할 일에 추가하기, 시트에 사용자 메뉴 만들기 같은 것입니다. 문서가 영어만 지원하므로 영어 프롬프트 틀을 만들어 두면 편합니다. 아래는 제가 직장인 업무에 맞춰 바꾼 예시이고, 직접 실행해 검증한 것은 아닙니다.
| 상황 | 영어 프롬프트 예시 |
|---|---|
| 시트 메뉴 만들기 | Create a custom menu in Google Sheets called "Send Notice" that runs the function sendNotice and shows a confirmation message after it finishes. |
| 폼 응답 정리 | When a Google Form response is submitted, copy the name, phone number and submitted time to the sheet named "Status" in the same spreadsheet. |
| 기존 함수 수정 | Update the function sendNotice so that it skips rows where column D is already marked "DONE". Keep the rest of the code unchanged. |
| 속도 개선 | This script takes over a minute to run. Read the sheet values once with getValues() instead of inside the loop and fix it. |
요청을 쓸 때는 함수 이름과 시트 이름, 열 위치를 구체적으로 적는 편이 좋습니다. 공식 문서도 기존 코드를 수정할 때 함수나 변수를 명시적으로 지목하라고 안내합니다. 막연한 '개선해 줘'보다 'sendNotice 함수에서 D열이 DONE인 행은 건너뛰어 줘'가 훨씬 정확한 결과로 이어집니다.
저희 블로그의 이전 글 중 AI에게 부분 수정 대신 전체 파일 교체를 시키는 이유를 쓴 글이 있습니다. 사이드 패널은 변경점을 diff로 보여 주기 때문에 이 문제가 상당 부분 줄어들지만, 전체를 수락하거나 거절해야 한다는 점은 같은 맥락에서 신경 써야 합니다.
5. 오류가 났을 때: Fix with Gemini 활용법
이 기능의 핵심은 디버깅입니다. 공식 문서가 안내하는 순서는 다음과 같습니다.
- 편집기에서 함수를 실행하고 실행 로그의 오류를 확인합니다.
- 'Fix with Gemini' 버튼을 누릅니다.
- Gemini가 오류 내용과 주변 코드를 보고 원인을 설명한 뒤 수정안을 diff로 제안합니다.
- 검토한 뒤 Accept All 또는 Reject All을 고릅니다.
- 저장하고 다시 실행해 해결됐는지 확인합니다.
null의 속성을 읽을 수 없다는 오류는 값이 빈 셀인지보다, 메서드를 호출하려는 객체가 null인지 먼저 확인해야 합니다. 유효한 Range의 getValue()는 빈 셀에서 빈 문자열을 반환합니다. 없는 시트 이름을 getSheetByName()으로 찾으면 null이 반환됩니다. 실무에서 흔한 오류 유형을 아래처럼 정리해 둘 수 있습니다. 이 표는 일반적인 앱스스크립트 오류 경험을 바탕으로 한 참고용이며, Gemini가 반드시 같은 답을 준다는 뜻은 아닙니다.
| 자주 보는 증상 | 흔한 원인 | 패널에 던질 질문 |
|---|---|---|
| null의 속성을 읽을 수 없음 | 시트 이름 오타 등으로 객체가 null인지 확인 | The error says a property of null cannot be read. Check the sheet name and cell references and fix it. |
| 권한이 필요함 | 처음 실행 시 OAuth 승인 미완료 | What permissions does this script need and why? |
| 출력이 이상함 | 열 번호가 0부터인지 1부터인지 혼동 | The script runs without error but the output is wrong. Please fix it. |
| 실행이 멈춘 듯함 | 반복문 안에서 시트 호출 반복 | The script hangs without producing output. Please fix it. |
문서는 오류가 나지 않아도 결과가 틀리거나 실행이 너무 느릴 때 위처럼 증상을 그대로 적어 요청하는 방법이 효과적이라고 설명합니다.
빈 셀과 없는 시트는 다릅니다: 최소 확인 예제
아래는 공식 API 반환값을 바탕으로 만든 연습용 코드이며, 실제 실행 결과를 제시하는 것은 아닙니다. 테스트용 스프레드시트에 ‘연습’ 탭을 만들고 A1을 비워 둔 뒤, 그 파일에 연결된 Apps Script에서 확인할 수 있습니다. 셀에 쓰거나 메일을 보내는 코드는 없습니다.
function inspectPracticeCell() {
const ss = SpreadsheetApp.getActiveSpreadsheet();
if (!ss) throw new Error('스프레드시트에 연결된 프로젝트에서 실행하세요.');
const sheet = ss.getSheetByName('연습');
if (!sheet) throw new Error('연습 탭을 찾지 못했습니다.');
const value = sheet.getRange('A1').getValue();
console.log(value === '' ? '빈 값' : value);
}예상 결과: A1이 비어 있으면 ‘빈 값’, A1에 숫자 0을 넣으면 0이 기록됩니다. 탭 이름을 ‘연습2’로 바꾸면 ‘연습 탭을 찾지 못했습니다’에서 멈춥니다. if (!value)만으로 빈 값을 판별하면 0까지 빈 값으로 취급하므로 피합니다.
Gemini에는 “셀 내용이 비어 있는 경우와 시트 객체가 없는 경우를 구분하고, 숫자 0은 유지해 줘”라고 요청하세요. 오류 문장이 사라졌는지뿐 아니라 이 세 조건이 모두 맞는지가 수정 완료 기준입니다.
반환값 참고: Range 공식 문서 · Spreadsheet 공식 문서 (2026-10-28 확인). 연습 입력과 검수 기준은 가상 예시입니다.
6. 쓸 때 주의할 점
- 권한 승인은 직접 읽고 누르기: Gemini가 만든 코드를 저장하고 처음 실행하면 일반적인 Workspace 권한 요청이 뜹니다. 문서도 요청 권한을 확인한 뒤 허용하라고 안내합니다. Gmail, 드라이브 전체 접근처럼 범위가 넓으면 정말 필요한지 따져 보세요.
- URL 누락: 보안 정제 때문에 생성된 코드에서 URL이 빠질 수 있다고 합니다. 필요한 주소는 프롬프트에 정확히 적어 주세요.
- 활성 파일 기준: Gemini는 편집기에서 열려 있는 파일을 기준으로 동작하고, 본인이 소유하거나 편집 권한이 있는 프로젝트에서만 작동합니다.
- 개인정보와 회사 자료: 시트에 이름, 연락처 같은 개인정보가 있다면 코드 요청에 실제 데이터를 붙이지 말고 열 이름만 알려 주는 편이 안전합니다. 회사 규정도 확인하세요.
- 검증은 사람 몫: 알림 발송, 삭제, 메일 전송 같은 되돌릴 수 없는 동작은 테스트용 시트에서 먼저 돌려 보세요.
7. 외부 AI와 사이드 패널, 어떻게 나눠 쓸까
사이드 패널이 모든 경우에 낫다고 단정할 수는 없습니다. 제가 확인한 것은 기능 설명이지 성능 비교가 아닙니다. 다만 사용 방식의 차이는 정리할 수 있습니다.
| 구분 | 사이드 패널 Gemini | ChatGPT·Claude 등 외부 AI |
|---|---|---|
| 맥락 전달 | 프로젝트 내용을 자동으로 참고 | 코드를 직접 붙여 넣어야 함 |
| 수정 반영 | 편집기에 diff로 바로 표시 | 복사해서 붙여 넣기 |
| 사용 조건 | 라이선스, 관리자 설정, 영어 전용 | 계정만 있으면 한국어 가능 |
| 적합한 상황 | 오류 수정, 기존 함수 보완 | 기획 상담, 한국어 설명, 여러 프로젝트에 걸친 설계 |
저는 기획과 한국어 설명은 외부 AI로, 실행 중 나오는 오류 수정은 사이드 패널로 나눠 쓰는 방식이 자연스럽다고 봅니다. 이 역시 제 판단이며, 계정 조건이 맞는지부터 확인하시길 권합니다.
자주 묻는 질문
Q. 무료 구글 계정으로도 쓸 수 있나요?
A. 공식 문서의 조건에는 무료 개인 계정이 들어 있지 않습니다. 개인은 Google AI Pro 또는 Ultra, 회사나 학교 계정은 지정된 Workspace 에디션과 관리자 설정이 필요합니다.
Q. 한국어로 물어보면 안 되나요?
A. 문서는 영어만 지원한다고 적고 있습니다. 한국어 요청이 막히는지, 부정확해지는지는 제가 확인하지 못했습니다. 영어 프롬프트를 쓰는 편이 안전합니다.
Q. 제안된 코드의 일부만 적용할 수 있나요?
A. 안 됩니다. 문서에 따르면 전체 수락 또는 전체 거절만 가능하므로 수정 요청을 작게 쪼개는 것이 좋습니다.
마무리
앱스스크립트는 비개발자가 업무를 자동화하는 가장 가까운 도구이고, 오류 때문에 멈추는 순간이 가장 큰 장벽입니다. 사이드 패널의 'Fix with Gemini'는 그 장벽을 낮추는 기능으로 보이지만, 계정 조건과 영어 전용이라는 제한을 먼저 확인해야 합니다. 큰 수정 전 백업, 작은 단위 요청, 권한 확인, 테스트 시트 사용 네 가지만 지켜도 실수를 크게 줄일 수 있습니다. 직접 써 본 뒤 달라진 점이 있으면 후기로 이어서 정리하겠습니다.
참고 자료
- Google for Developers: Use the Gemini side panel in the Apps Script editor
- Google Workspace Help: Turn access to Google Workspace with Gemini Beta on or off
- AppsScriptPulse: Gemini in the Apps Script IDE, 8 Practical Developer Workflows