Claude Code ·
서버 없이 폼 하나 만들기, 구글시트+Apps Script를 클로드한테 맡기는 법
이메일 등록 폼 하나, 라이선스 키 하나 처리하려고 진짜 서버를 띄우긴 부담스럽습니다. 구글시트를 데이터베이스로, Apps Script를 API 서버로 쓰면 돈 한 푼 안 들이고 꽤 쓸만한 뒷단을 만들 수 있습니다. 세 번 만들어 보며 굳어진 패턴을 정리했습니다.
정적 사이트(Astro, 깃허브 페이지 등)는 서버가 없습니다. 그런데 “이메일 모으기”, “라이선스 키 확인”, “발행 기록 저장” 같은 건 어딘가에 데이터를 저장하고 처리하는 **뒷단(백엔드)**이 있어야 합니다. 진짜 서버(Node.js, 데이터베이스 등)를 새로 띄우고 관리하는 건 비개발자 입장에서 꽤 큰 일입니다. 저는 이걸 구글시트(데이터 저장) + Google Apps Script(요청을 받아 처리하는 서버) 조합으로 세 번 풀었습니다 — 라이선스 서버, 발행 기록 자동화, 이메일 구독자 수집까지. 이 글은 그 조합이 어떻게 동작하는지, 어떤 모양으로 코드를 짜면 재사용하기 좋은지 정리한 것입니다.
역할: 구글시트+Apps Script로 가벼운 백엔드(API 서버)를 설계하고 코드를 작성하는 담당
맥락: 정적 사이트에서 <받고 싶은 데이터, 예: 이메일 주소와 등록한 글 제목>를 모으고 싶다. 서버는 안 띄우고 구글시트에 저장하려고 한다.
작업: 1) 구글시트에 어떤 열(컬럼) 구조로 저장할지 제안해라. 2) 같은 값이 중복으로 안 쌓이게 막는 로직을 넣어라(기준이 될 열을 먼저 물어봐라). 3) Google Apps Script의 doPost(e) 함수로 요청을 받아 그 시트에 기록하는 코드를 작성해라. 4) 내 정적 사이트의 클라이언트 코드에서 이 Apps Script 웹앱을 호출하는 fetch 코드도 같이 작성해라(브라우저 CORS 문제가 안 생기는 방식으로).
제약: 비밀키·토큰 같은 민감한 값은 코드에 그대로 박아넣지 말고 CONFIG 객체로 분리해서, 내가 배포할 때 채워 넣게 해라.
출력: Apps Script 코드 전체, 클라이언트 fetch 코드, 그리고 배포 순서(구글시트 만들기 → Apps Script 붙여넣기 → 웹 앱으로 배포)를 단계별로.
왜 이 조합인가
- 비용이 0원입니다. 구글시트와 Apps Script 둘 다 개인 구글 계정으로 무료로 씁니다.
- 배포가 로그인 몇 번으로 끝납니다. 서버를 임대하고, 도메인을 연결하고, 환경변수를 설정하는 과정이 없습니다. “배포 → 새 배포 → 웹 앱”만 누르면 바로 주소가 나옵니다.
- 데이터를 바로 눈으로 봅니다. 쌓인 데이터가 구글시트 화면 그 자체라서, 비개발자도 별도 관리자 화면 없이 바로 확인·수정할 수 있습니다.
단점도 있습니다. 대량 트래픽에는 안 맞고(Apps Script는 실행 시간·호출 횟수 제한이 있습니다), 복잡한 조회 로직에는 느립니다. “폼 하나 받기”, “소량의 기록 쌓기” 같은 작은 쓰임새에 맞는 조합입니다.
STEP 1. 데이터 구조부터 정한다
표 하나(시트 하나)에 어떤 열을 둘지 먼저 정합니다. 이메일 수집이라면 이렇게 단순하게 시작하면 됩니다.
[이메일] [등록시각] [어디서 등록했는지]
STEP 2. 중복 방지 기준을 정한다
“같은 이메일이 다시 등록되면 어떻게 할지”를 미리 정해야 합니다. 저는 세 번 다 “이미 있으면 새 행을 추가하지 않고 성공만 돌려준다” 방식을 썼습니다. 사용자 입장에서는 또 등록해도 에러가 안 나고, 시트에는 중복이 안 쌓입니다.
STEP 3. Apps Script의 기본 뼈대
구글시트 메뉴 확장 프로그램 → Apps Script로 들어가서 아래 모양의 코드를 넣습니다. doPost(e)라는 이름의 함수를 만들면, 이 웹앱으로 오는 모든 POST 요청이 이 함수로 들어옵니다.
const CONFIG = {
SPREADSHEET_ID: '여기에_스프레드시트_ID_입력',
SHEET_NAME: '구독자',
};
function doPost(e) {
const body = JSON.parse(e.postData.contents || '{}');
const email = String(body.email || '').trim().toLowerCase();
if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
return jsonOutput_({ ok: false, error: 'invalid_email' });
}
const sheet = SpreadsheetApp.openById(CONFIG.SPREADSHEET_ID).getSheetByName(CONFIG.SHEET_NAME);
const lastRow = sheet.getLastRow();
const existing = lastRow > 1 ? sheet.getRange(2, 1, lastRow - 1, 1).getValues().flat() : [];
if (!existing.includes(email)) {
sheet.appendRow([email, new Date(), body.source || '']);
}
return jsonOutput_({ ok: true });
}
function jsonOutput_(obj) {
return ContentService.createTextOutput(JSON.stringify(obj)).setMimeType(ContentService.MimeType.JSON);
}
핵심은 이메일 형식을 서버 쪽에서도 한 번 더 검사한다는 점입니다. 화면의 입력창이 type="email"이어도, 요청 자체는 누구나 임의로 보낼 수 있기 때문에 서버 쪽 검사가 없으면 이상한 값이 그대로 쌓일 수 있습니다.
이메일 등록하면 이어서 보기
STEP 4. 클라이언트에서 부를 때 CORS를 피하는 법
정적 사이트의 자바스크립트에서 이 Apps Script 웹앱을 fetch로 부르면, 평범한 Content-Type: application/json으로 보냈을 때 브라우저가 먼저 “사전 요청(preflight)“을 보내는데, Apps Script는 이 사전 요청에 제대로 응답하지 않아서 실패하는 경우가 있습니다. 이걸 피하는 방법은 Content-Type을 text/plain으로 보내는 것입니다. Apps Script의 e.postData.contents는 어차피 원문 그대로 받기 때문에, 보내는 쪽에서 JSON 문자열을 만들어서 text/plain으로 포장해 보내면 사전 요청 없이 바로 통과합니다.
fetch(API_URL, {
method: 'POST',
headers: { 'Content-Type': 'text/plain;charset=utf-8' },
body: JSON.stringify({ email: input.value, source: '글-slug' }),
})
.then((r) => r.json())
.then((out) => {
if (out.ok) {
// 성공 처리
}
});
이 방식을 세 프로젝트에서 전부 똑같이 썼습니다. 한 번 패턴을 만들어두면, 다음에 비슷한 기능을 만들 때 거의 그대로 복사해서 씁니다.
STEP 5. 배포하기
- 구글시트를 하나 만들고, 그 시트에서 확장 프로그램 → Apps Script로 코드 작성
- 배포 → 새 배포 → 유형: 웹 앱 → 실행 계정: 나, 액세스 권한: 모든 사용자
- 권한 승인 화면이 뜨면 승인(이 단계에서 “차단된 앱” 에러를 만날 수 있는데, 그건 별도 글에서 다룹니다)
- 나온 웹 앱 URL을 클라이언트 코드의
API_URL에 넣기
STEP 6. 코드를 고친 뒤 재배포할 때 주의할 점
스크립트 내용을 고쳤다고 끝이 아닙니다. **“새 배포”**를 또 누르면 URL이 바뀝니다. 코드만 바꾸고 URL은 그대로 유지하고 싶다면, 배포 → 배포 관리 → (기존 배포) 편집(연필 아이콘) → 버전: 새 버전 → 배포로 가야 합니다. 이 차이를 모르고 “새 배포”를 누르면, 이미 사이트에 박아둔 URL이 전부 못 쓰게 됩니다.
자주 막히는 지점
| 증상 | 원인 | 해결 |
|---|---|---|
| fetch가 계속 실패하거나 응답이 없음 | CORS 사전 요청이 막힘 | Content-Type을 text/plain으로 보내기 |
| 코드 고쳤는데 사이트에 반영이 안 됨 | “새 배포”를 눌러서 URL이 바뀜 | 기존 배포를 “새 버전”으로 편집 |
| 시트에 같은 값이 계속 중복으로 쌓임 | 중복 체크 로직이 없음 | 저장 전에 기존 값 목록과 대조 |
| 응답이 JSON이 아니라 이상한 HTML이 옴 | 권한 승인이 아직 안 끝났거나 스프레드시트 ID가 틀림 | CONFIG의 ID를 다시 확인, 승인 화면부터 재시도 |
돌아보며
세 번째로 이 조합을 만들 때는 거의 복사-붙여넣기 수준으로 끝났습니다. 매번 “진짜 서버가 필요한가”부터 다시 고민하지 않고, “이 정도 규모면 시트+Apps Script로 충분하다”는 판단 기준이 생긴 게 가장 큰 변화였습니다. 작은 기능 하나에 서버 전체를 새로 설계하는 건 과한 일이었고, 구글시트가 이미 “데이터를 저장하고 눈으로 확인하는” 역할을 완벽하게 대신해 줬습니다.