여러 사람이 한 시트에 쓰는 점검 앱: 동시성·중복·내보내기 설계
체크리포트 데모를 만들며 실제로 헤맨 지점과 코드. 공유 시트 동시 저장은 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으로 넘긴다. 단 사람 승인 게이트는 필수.