API로 들어온 데이터를 Google Sheets에 자동으로 쌓는 가장 짧은 길

안녕하세요, 3Min API 개발을 이끌고 있는 yeonghyeon입니다.

오늘 글은 운영자분들의 요청에서 시작되었습니다. "주문이 들어오면 그냥 구글 시트 한 줄에 자동으로 쌓이게 해주세요." 같은 요청이 한두 번이 아니었거든요. 자동화 도구를 따로 붙이는 방법은 이미 있었지만, 도구 하나가 더 늘어나는 것 자체가 부담입니다. 그래서 3Min API 안에 Google Drive와 시트 연동을 직접 넣었습니다. 구글 계정 한 번 연결하면 끝이고, 그 뒤로는 API가 호출될 때마다 본인 시트에 한 줄씩 자동으로 쌓입니다.

이 글은 그 기능을 처음 만나는 분께 드리는 안내문입니다. 왜 이런 기능이 필요했는지, 다른 자동화 도구를 끼우는 방식과 무엇이 다른지, 오늘 어디까지 5분 안에 해볼 수 있는지를 차례로 정리했습니다. 사전지식은 필요 없습니다.

"시트에 그냥 쌓이게 해주세요"라는 요청 뒤에 있는 진짜 문제

데이터를 시트에 모으려는 이유는 거의 비슷합니다. 매출을 한눈에 보려고, 직접 필터·정렬을 걸어 보려고, 회계사·마케터에게 그대로 넘겨주려고. 시트는 이런 용도에 가장 가깝고, 다른 도구로 옮길 필요도 없습니다. 즉 시트가 목적이고, 그 사이의 모든 단계는 군더더기라는 뜻입니다.

그런데 "API로 받은 데이터"와 "내 시트" 사이를 잇는 일이 의외로 쉽지 않습니다. 보통은 이런 길을 따라갑니다.

1. 3Min API 같은 곳으로 데이터를 받고
2. Zapier·Make·n8n 같은 자동화 도구를 또 하나 가입해서
3. 웹훅으로 그 도구에 데이터를 흘리고
4. 그 도구가 다시 Google Sheets에 행을 추가

잘 돌면 좋습니다. 다만 운영하는 입장에서 세 가지 부담이 따라옵니다.

• 도구 비용 — 자동화 도구마다 월 구독료가 붙고, 호출량이 늘면 더 비싼 플랜으로 올라가야 합니다.
• 러닝커브 — 노드를 잇고, 트리거를 만들고, 인증을 또 한 번 붙여야 합니다. "주문 한 줄 쌓는 일"치고 단계가 너무 많습니다.
• 유실 위험 — 자동화 도구가 점검 중이거나 호출 한도를 넘기면 그 사이에 들어온 데이터가 조용히 버려질 수 있습니다. 시트에 행이 한 줄 빠져 있어도 무엇이 빠졌는지 알 길이 없습니다.

특히 마지막 항목이 결정적이었습니다. 데이터를 잃는 일은 비즈니스에서 단순한 불편이 아니라 장부에 구멍이 뚫리는 일입니다. 자동화 도구가 잘 돌고 있다는 가정 위에 비즈니스를 얹기는 어렵습니다.

그래서 우리가 고른 답 — 시트 연동을 제품 안에 넣기

해결 방법은 직선적이었습니다. 3Min API와 Google Drive 사이에 다른 도구가 끼지 않도록 만드는 것. Google 계정 한 번 연결해 동의 화면에서 권한 한 가지를 허용해 주시면 됩니다. 그 뒤로는 API가 호출될 때마다 본인 Drive의 시트에 한 줄씩 자동으로 기록됩니다. 자동화 도구도, 추가 구독도, 트리거 설정도 필요 없습니다.

외부 호출 → 3Min API에 먼저 안전하게 저장 → Google Sheets에 자동 기록. 자동화 도구가 사이에 끼지 않습니다.

이렇게 했을 때 무엇이 달라지는지 짧게 정리해 두겠습니다.

• 도구 한 개로 끝납니다. 3Min API 안에서 모든 설정이 마무리됩니다.
• 데이터는 항상 먼저 안전하게 저장됩니다. 시트에 행이 추가되기 전에, 호출 자체가 3Min API 로그·아카이브에 그대로 들어갑니다. 시트 기록은 그 위에 얹히는 보너스이지 생명줄이 아닙니다.
• 실패해도 원본은 남습니다. 일시적인 한도 초과가 있어도 자동으로 재시도하고, 끝까지 실패해도 시트에서 한 줄이 비는 것이지 데이터가 사라지진 않습니다.
• 권한은 좁게. Google에 요청하는 권한은 drive.file 단 하나입니다. 3Min API가 직접 만든 시트에만 접근하고, 다른 Drive 자료에는 손대지 못합니다.

요약하면 이렇습니다. 시트가 목적이라면, 그 사이는 짧을수록 좋다.

연동했을 때 Drive에서 무엇이 보이나

실제로 연결했을 때 Drive에 어떤 모양이 만들어지는지 먼저 보시는 게 가장 빠릅니다. 본인 Drive 최상위에 3Min API라는 폴더 하나가 자동으로 생기고, 그 안이 다음과 같이 정리됩니다.

3Min API/
├── user-signup/                              ← 엔드포인트별 폴더
│   ├── sandbox_user-signup_2026-04           ← 월별 시트 (샌드박스)
│   ├── sandbox_user-signup_2026-05
│   └── production_user-signup_2026-05        ← 월별 시트 (프로덕션)
└── order-create/
    └── production_order-create_2026-05

규칙은 단순합니다. 엔드포인트마다 폴더 하나, 그 안에 환경(샌드박스/프로덕션)과 월별로 시트 한 장씩. 새 달이 시작되면 다음 호출 시점에 새 시트가 자동으로 만들어지므로, 한 시트에 너무 많은 행이 쌓여 무거워질 걱정도 없습니다. 시트를 다른 폴더로 옮기시거나 이름을 바꾸셔도 안전합니다. 3Min API는 시트를 파일 ID로 추적하기 때문에 위치와 이름이 바뀌어도 같은 파일에 계속 행을 추가합니다.

각 시트의 첫 행, 즉 헤더는 두 종류로 구성됩니다.

• 메타 컬럼 — record_id, created_at, config_version, operation, status, collaboration_key. 시스템이 자동으로 채우는 컬럼입니다. 어떤 호출이었는지 추적하는 정보예요.
• 페이로드 컬럼 — 정의하신 필드(이메일·금액·주소…)가 payload_ 접두어를 달고 한 컬럼씩 펼쳐집니다. 메타 컬럼과 출처가 헷갈리지 않도록 일부러 구분했습니다.

나중에 엔드포인트에 새 필드를 추가하시면 시트 헤더가 오른쪽으로 자동 확장됩니다. 이전 행의 새 컬럼 자리는 빈 칸으로 남고, 새 호출부터 그 칸이 채워집니다. 시트에서 직접 헤더를 지우거나 순서를 바꾸지만 않으시면 매핑은 계속 자연스럽게 맞춰집니다.

샌드박스와 프로덕션은 따로 움직입니다

3Min API의 모든 엔드포인트는 샌드박스(개발·테스트용)와 프로덕션(실서비스용)이 완전히 분리되어 있습니다. Google Sheets 연동 역시 이 분리를 그대로 따릅니다. 같은 엔드포인트라도 환경 탭마다 별도로 연동을 켜고 끌 수 있고, 시트 파일도 환경별로 따로 만들어집니다.

그래서 자주 만나시게 되는 한 가지 안전장치가 있습니다. 샌드박스에서 시트 연동까지 마친 엔드포인트를 프로덕션으로 배포해도, 프로덕션 시트 연동은 자동으로 따라가지 않습니다. 프로덕션 환경 탭에서 한 번 더 연동 시작을 눌러 주셔야 실서비스 시트 기록이 시작됩니다. 일부러 한 번 더 묻습니다. 테스트 데이터와 진짜 매출 데이터가 한 시트에 섞이는 것은 아주 골치 아픈 사고이기 때문입니다.

5분 따라하기 — 첫 시트 기록까지

이론보다 실제 동작을 한 번 보시는 게 빠릅니다. 아래 순서대로 따라오시면 됩니다. 코드는 한 줄도 필요 없고, 도구도 3Min API 하나면 됩니다.

1. 계정 만들고 첫 엔드포인트 만들기

가입 후에는 첫 엔드포인트를 만드는 짧은 온보딩이 자동으로 안내됩니다. Free 플랜 그대로도 Google Sheets 연동을 쓸 수 있어요. 운영하시는 비즈니스에 맞춰 첫 엔드포인트 하나만 만들어 보시면 됩니다. 무엇이든 좋습니다. 처음에는 주문 접수, 문의 등록, 예약 신청처럼 한 사건이 한 줄로 떨어지는 단순한 형태가 가장 어울립니다. 필드는 두세 개로 시작하셔도 충분합니다. 더 자세한 절차는 엔드포인트 만들기 매뉴얼에 정리해 두었습니다.

엔드포인트가 무엇인지부터 더 천천히 잡고 싶으시면 API란? 비개발자를 위한 기초 가이드를 먼저 읽으시는 것을 권합니다. "정해진 주소로 정해진 모양의 메시지를 주고받는 창구"라는 한 줄 감각만 잡으시면 그 다음은 자연스럽게 따라옵니다.

2. Google Sheets 카드에서 연동 시작

엔드포인트 상세 페이지를 여시면 화면 안에 Google Sheets라는 카드가 보입니다. 카드 안의 연동 시작 버튼을 누르시면 Google 동의 화면으로 넘어갑니다.

동의 화면에서 3Min API가 요청하는 권한은 drive.file 한 가지입니다. 본인이 만든 시트에만 접근할 수 있는 좁은 권한이에요. 권한별 체크박스가 함께 보이는 경우에는 모든 체크박스를 켠 상태로 동의해 주셔야 시트 기록이 정상 작동합니다.

3. 테스트 전송으로 확인

연동이 완료되면 카드에 연동됨 배지와 함께 시트 파일명이 표시됩니다. 이때 테스트 전송 버튼을 한 번만 눌러 보시기 바랍니다. 샘플 행 한 줄이 시트에 기록되어, 실제 호출 한 건이 어떻게 시트로 옮겨지는지 눈으로 확인하실 수 있습니다. 개발 도구 없이 결과를 바로 보는 가장 빠른 길입니다.

이제 이 엔드포인트로 API가 호출될 때마다 시트 마지막 행에 자동으로 기록됩니다. 여기까지가 전부입니다.

알아두시면 좋은 점

Google 시트 자체의 쓰기 한도가 있습니다

시트 기록에는 3Min API가 정한 한도가 아닌, Google이 정한 사용자당 시트 쓰기 한도가 있습니다. 보통 분당 60건 수준이고, 같은 Google 계정으로 연동된 모든 엔드포인트가 이 한도를 함께 씁니다. 시트 자동 기록 기능 전체가 이 한도 위에서 움직인다고 보시면 됩니다.

평소 트래픽에서는 한도 자체를 의식하실 일이 거의 없습니다. 다만 시간이 지나 호출이 꾸준히 늘어 한도에 자주 부딪히기 시작하신다면, 이건 비즈니스가 잘 되고 있다는 좋은 신호이기도 합니다. Google 정책상 개별 사용자 단위로 한도를 더 풀어드리기는 어려우므로, 그 시점이라면 시트는 요약·대시보드 용도로 두시고 원본 데이터는 로그·아카이브에서 일/주 단위로 내려받아 보관하시거나, 자체 데이터베이스 도입을 검토하실 시점입니다. 3Min API는 그 단계에서도 그대로 진입 게이트웨이로 쓰실 수 있으니 마이그레이션 부담 없이 옮겨가실 수 있어요.

시스템 알림으로 상태를 받아보실 수 있습니다

한도 초과나 일시 장애로 시트 기록에 문제가 생겼을 때 즉시 알아채실 수 있도록, 엔드포인트마다 Discord/Slack/Telegram 알림 채널을 등록해 두실 수 있습니다. 엔드포인트 상세의 시스템 알림 설정에서 채널을 한 번 연결해 두시면, 시트 쓰기 실패와 Google 재인증 요청 두 가지 사건이 그 채널로 바로 통지됩니다. 매번 대시보드를 들여다보지 않아도 시트가 제대로 채워지고 있는지 확인할 수 있는 가장 가벼운 방법입니다.

그동안 3Min API가 자동으로 처리하는 것들

알림이 갈 만한 사건이 실제로 자주 일어나지는 않습니다. 그 사이를 3Min API가 다음 세 가지 방식으로 메우고 있기 때문입니다.

• 자동 재시도 — 일시적인 한도 초과(429)나 일시 장애가 발생하면 약 5분간 자동으로 재시도해서 대부분 흡수합니다. Google에는 한도 상향도 지속적으로 신청해 처리량을 계속 늘려가고 있고요.
• 원본은 항상 안전 — 자동 재시도 후에도 시트 기록이 끝까지 실패하면 시트에만 행이 빠지고, 원본 호출은 로그와 아카이브에 그대로 보존됩니다. 시트 기록이 실패해도 데이터가 사라지진 않습니다.
• 호출 순서대로 차례로 처리 — 시트 기록은 호출 순서대로 한 줄씩 차례로 처리되고, 시트에 행이 보이기까지는 보통 수 초 이내입니다. 호출이 한꺼번에 몰리는 시간대에는 평소보다 늦게 반영되거나 행 순서가 호출 순서와 살짝 다르게 보일 수 있는데, 정확한 순서가 필요하시면 시트의 created_at 컬럼으로 정렬해서 보시면 됩니다.

오늘 해보실 수 있는 한 가지

거창한 자동화를 한 번에 세우려고 하지 않으셔도 됩니다. 권하는 일은 단 한 가지입니다.

첫 엔드포인트 하나 만들기 → Google Sheets 연동 켜기 → 테스트 전송 한 번.

여기까지만 해보시면 본인 Drive에 비즈니스 데이터가 자동으로 쌓이기 시작하는 작은 파이프라인 하나가 완성됩니다. 그 위에 새 필드를 더해 보시고, 거래처에 API 키를 전달해 보시고, 매출 컬럼으로 차트를 그려 보시면 됩니다. 한 번에 모든 자동화를 짜시기보다, 가장 짧은 길로 한 줄이 시트에 들어오는 장면부터 보시는 것을 권합니다.

더 자세한 설정과 예외 상황은 Google Sheets 연동 매뉴얼에 모아 두었습니다. 왜 이 도구를 만들게 되었는지 더 듣고 싶으시면 왜 3Min API를 만들었는가에 그 배경을 적어 두었으니 함께 봐 주시면 좋겠습니다.