구글 앱스크립트로 업무 자동화하기 — 완전 가이드
구글 앱스크립트(GAS)로 주문·예약·재고·정산·현장 입력 같은 반복 업무를 자동화하는 법. 무엇이 되고, 어디까지 0원이고, 언제 한계에 부딪히는지 한 곳에 정리한 길잡이.
모든 태그 태그
#Apps Script
15 개의 글
여러 사람이 한 시트에 쓰는 점검 앱: 동시성·중복·내보내기 설계
체크리포트 데모를 만들며 실제로 헤맨 지점과 코드. 공유 시트 동시 저장은 ScriptLock + 멱등 키로 막고, 셀에는 메타데이터만, 내보내기는 시간 예산으로 끊는다. 좋은 코드와 나쁜 코드를 함께 본다.
여러 사람이 쓰는 점검 앱은 어디가 다른가
혼자 쓰는 앱은 화면만 있으면 된다. 여러 점검자가 같은 데이터를 쓰는 점검 앱은 공유, 충돌, 보고서가 핵심이다. 그래도 범위를 좁히면 GAS·시트·드라이브로 유지비 없이 시작할 수 있다. 직접 써볼 수 있는 공개 데모도 있다.
셀을 한 칸씩 읽지 마라: 서비스 호출이 진짜 비용이다
GAS에서 느린 건 자바스크립트가 아니라 Sheets·Drive 같은 서비스 호출이다. 루프 안 getValue/setValue를 일괄 getValues/setValues로 바꾸면 수십 배 빨라진다.
시트 셀에 JSON·이미지를 통째로 넣으면 터진다
구글 시트 셀은 5만 자에서 막힌다. 사진·서명을 data URL로 기록 행에 넣으면 저장이 깨진다. 셀에는 메타데이터만 남겨라.
웹앱 배포 설정 하나가 보안 모델을 정한다: Execute as / 접근 권한
‘누구로 실행’ × ‘누가 접근’ 조합이 데이터 권한과 코드 공개 여부를 결정한다. 공개 앱은 앱 레벨 인증을 따로 설계해야 한다.
GAS 6분 실행 한도: 멈추기 전에 끊어서 재개하라
Apps Script는 한 번 실행이 6분에서 강제 종료된다. 대량 작업은 청크 + 커서 + 시간 트리거 재개로 설계해야 절반만 처리되는 사고를 막는다.
PropertiesService는 데이터베이스가 아니다: 9KB의 벽
Properties 값은 한 개당 약 9KB가 한계다. 캐시는 유실돼도 되는 데이터에만. 큰 상태는 Sheet·Drive·외부 DB로. JSON 직렬화는 타입을 잃는다.
모바일에서 화면을 이미지로 저장할 때 멈추는 진짜 이유
SVG foreignObject로 DOM을 캡처하면 모바일 Safari·GAS iframe에서 멈추거나 빈 이미지가 나온다. 직접 캔버스에 그리고, 다운로드는 Web Share로 받아라.
동시에 같은 시트를 쓰면 깨진다: LockService와 30 동시 실행 천장
여러 사용자·트리거가 같은 자산을 쓰면 번호가 겹치고 행이 덮인다. tryLock + finally + flush로 막고, 동시 실행 30/user 천장을 설계에 넣어라.
재배포할 때마다 주소가 바뀌면 안 된다: /exec URL 고정
clasp으로 새 버전을 올릴 때 deployment ID를 재사용하면 /exec URL이 고정된다. 공유 시트 쓰기는 LockService로 막는다.
외부 호출은 가끔 실패한다: 지수 백오프와 재시도 예산
429·503·타임아웃 같은 일시적 실패는 재시도로 살릴 수 있다. 단 멱등성 없는 쓰기는 멱등키 없이 재시도하지 마라. 6분 안에서 멈춰라.
HtmlService 앱은 껍데기 먼저: 비동기 로드와 모바일 뒤로가기
템플릿에서 긴 데이터 로드를 하면 첫 화면이 늦는다. 껍데기를 먼저 그리고 google.script.run으로 비동기 로드하되, 모든 호출에 실패 핸들러를 붙여라.
GAS를 졸업해야 할 때: 한계 신호와 외부 DB 이전
GAS는 짧은 자동화에 강하고 장시간·대량·다수 동시에 약하다. 할당량은 계정 단위로 공유된다. 한계 신호를 미리 알고 이전 계획을 세워라.
GAS에 지능과 엔진룸을 더하기: Vertex AI와 Cloud Run
분류·요약·초안은 Vertex AI(Gemini)를 GAS에서 직접 호출해 더한다. 6분을 넘는 무거운 일은 Cloud Run으로 넘긴다. 단 사람 승인 게이트는 필수.