n8n 구글 스프레드시트 연동으로 데이터 자동화

n8n에서 구글 스프레드시트 연동을 처음 시도하면, 생각보다 자주 막힌다. 화면상으로는 연결이 된 것처럼 보이는데 막상 행이 추가되지 않거나, 분명 같은 시트인데 “Sheet not found”가 뜨거나, 데이터가 들어가도 열이 엉뚱하게 밀려서 들어가는 식이다. 처음엔 단순 오타처럼 보이지만, 실제로는 인증 방식, 시트 공유 권한, 열 매핑, Append/Update 동작 방식이 한꺼번에 얽혀 있는 경우가 많다.

특히 마케팅팀, 운영팀, CS팀처럼 여러 채널에서 들어오는 데이터를 구글 시트 하나로 모아 관리하는 환경이라면 이 연동은 그냥 편의 기능이 아니다. 슬랙 알림, 문의 폼, 메일침프, 에어테이블, CRM, 웹훅 입력값이 매번 시트로 정리되어야 한다면, n8n과 구글 스프레드시트 연동은 실무 자동화의 거의 기본 축에 가깝다. 손으로 복붙하는 일은 금방 실수로 이어지고, 한번 꼬인 데이터는 나중에 복구하는 시간이 더 오래 걸린다.

저도 처음에는 “시트에 행 하나 추가하는 거야 쉽겠지”라고 봤다가 생각보다 오래 헤맸다. 특히 인증은 됐는데 쓰기가 안 되는 경우, 시트 이름은 맞는데 범위가 안 맞는 경우, Append는 되는데 열 순서가 밀리는 경우가 실제로 자주 나온다. 이 글은 단순 연결 방법 소개보다, 왜 자꾸 엉뚱한 열에 기록되는지, 왜 권한 오류가 뜨는지, 그리고 실무에서는 어떤 구조로 잡아야 덜 망가지는지를 중심으로 정리한 가이드다.

구글 스프레드시트 연동은 단순 쓰기 성공보다 열 구조와 권한, Append/Update 기준을 미리 고정하는 일이 더 중요하다. 초반에 이 기준이 없으면 자동화는 돌아가도 데이터가 금방 지저분해진다.

n8n 구글 스프레드시트 연동의 핵심 원리

n8n의 Google Sheets 노드는 구글 시트를 문서(Document)와 시트(Sheet within document) 단위로 다룬다. 공식 문서 기준으로도 문서 생성, 행 추가, 행 읽기, 행 업데이트, Append or Update Row 같은 동작이 따로 나뉘어 있다. 그래서 처음부터 “그냥 시트에 값 쓰기”라고 생각하면 금방 헷갈린다. 실제로는 어떤 문서에, 어떤 시트에, 어떤 열 기준으로, 어떤 방식으로 넣을지를 먼저 정해야 한다.

인증 방식도 생각보다 중요하다. n8n 공식 문서에서는 Google 서비스 노드 인증에 OAuth2와 Service Account 두 가지를 안내하고 있고, 일반적으로는 OAuth2가 더 널리 지원되고 설정도 쉽다고 설명한다. 반대로 서비스 계정은 특정 환경에서는 편하지만, 해당 서비스 계정 이메일을 시트에 직접 공유해야 하고, 조직 정책에 따라 접근이 막히는 경우도 있다. 즉, 개인 계정 중심이면 OAuth2가 편하고, 서버 간 자동화나 공유 계정 없는 환경에서는 서비스 계정을 검토하는 식이 보통 더 현실적이다.

많은 사용자가 “왜 내 시트에 아무것도 입력되지 않지?”라고 느끼는 이유도 여기서 갈린다. 연결 버튼을 눌렀다고 바로 쓰기 권한이 생기는 게 아니다. 사용한 구글 계정이 해당 시트에 편집 권한을 가지고 있어야 하고, 서비스 계정이라면 서비스 계정 이메일도 시트의 공유 대상에 편집자로 추가돼 있어야 한다. 이 부분을 빼먹으면 읽기는 되는데 쓰기가 안 되거나, 아예 문서 자체를 못 찾는 상황이 자주 생긴다.

1. 크레덴셜 올바르게 설정하기

n8n에서 Google Sheets 노드를 처음 붙일 때 가장 먼저 해야 할 일은, 연결 자체보다 “누가 이 시트를 수정할 것인가”를 분명히 하는 것이다. 개인용 자동화라면 OAuth2가 가장 직관적이다. 로그인한 구글 계정으로 바로 시트 접근이 가능하니 테스트도 빠르다. 반면 팀용 자동화나 서버 기반 운영이라면 서비스 계정이 더 안정적으로 느껴질 수 있지만, 공유 설정을 빼먹으면 거의 100% 권한 오류를 보게 된다.

실무에서는 여기서 자주 실수한다. 내 개인 구글 계정으로 열면 시트가 보이니까 n8n도 당연히 쓸 수 있을 거라고 생각하는 식이다. 하지만 n8n에 연결된 계정이 다르면 결과는 완전히 달라진다. 특히 공유 드라이브나 팀 문서는 소유자와 실행 계정이 다를 수 있어서, “분명 보이는 문서인데 노드에서는 안 나온다”는 상황이 꽤 자주 나온다.

2. 시트 ID와 범위 정확히 지정하기

구글 스프레드시트 연동에서 의외로 자주 틀리는 게 시트 ID 입력 방식이다. 전체 URL을 넣는 게 아니라, /d/와 /edit 사이의 문서 ID만 정확히 써야 한다. 이건 기초처럼 보이지만, 실제로는 전체 URL을 그대로 붙여넣어서 문서 선택이 안 되는 경우가 꽤 많다.

범위 지정도 마찬가지다. 시트 이름과 범위를 같이 쓸 때는 '주문 내역'!A2:E처럼 시트 이름을 정확히 넣고, 공백이나 특수문자가 있으면 작은따옴표까지 같이 써주는 편이 안전하다. 반대로 열 전체를 다 쓸 필요가 없는데도 너무 넓은 범위를 읽어오면 실행 속도도 느려지고, 중복 체크 로직도 괜히 무거워진다.

오류 유형원인 및 해결책
“Sheet not found”시트 이름 오타, 숨김 시트, 공백/특수문자 처리 누락 가능성. 정확한 시트명과 따옴표 여부를 다시 확인.
“Unable to parse range”범위 형식 오류. 예: '주문내역'!A2:E 또는 A:C처럼 다시 정리.
“No data written”열 매핑 누락, 필수 값 비어 있음, Append/Update 동작 방식 오해 가능성. 입력 데이터 구조를 먼저 확인.

실무에서 자주 쓰는 n8n 구글 스프레드시트 자동화 패턴

단순히 데이터를 한 줄 넣는 수준이라면 Google Sheets 연동은 금방 된다. 그런데 실무에서 진짜 자주 쓰는 패턴은 그보다 조금 더 복합적이다. 신규 문의를 시트에 쌓되 중복 이메일은 제외하거나, 특정 상태 값이 들어온 행만 기록하거나, 여러 서비스에서 온 데이터를 하나의 리포트 시트에 계속 누적하는 식이다. 이때부터는 “노드를 붙였다”보다 “흐름을 어떻게 설계했느냐”가 훨씬 중요해진다.

보통은 트리거 → 데이터 가공 → 조건 확인 → 시트 기록 구조로 잡는 편이 가장 덜 꼬인다. Append 모드 하나로 밀어붙이면 처음엔 편하지만, 나중엔 중복과 열 정렬 문제 때문에 시트가 금방 지저분해진다. 반대로 처음부터 Update만 생각하면 키 컬럼 설계가 애매할 때 더 복잡해진다. 그래서 초반에는 Append 중심으로 시작하되, 중복 판단 컬럼과 기준 키를 먼저 정해두는 편이 좋다.

📌 핵심 포인트 & 주의사항

Google Sheets API는 프로젝트/사용자 기준 요청 한도와 쓰기 제한에 영향을 받기 때문에, 여러 워크플로우가 같은 시트를 동시에 두드리면 생각보다 빨리 지연이나 실패가 나온다. 실무에서는 요청을 1건씩 자주 보내기보다, 여러 행을 모아 배치로 처리하거나 실행 간격을 두는 편이 훨씬 안정적이다. 특히 마케팅 리포트나 로그 수집처럼 누적성 데이터는 1분 단위로 쪼개 쓰기보다, 묶어서 넣는 쪽이 장애가 덜 난다.

3. Append와 Update를 구분해서 써야 하는 이유

공식 문서 기준으로도 Google Sheets 노드는 Append Row, Update Row, Append or Update Row를 따로 제공한다. 이름은 비슷하지만 실무 느낌은 꽤 다르다. Append는 말 그대로 새 행을 계속 추가하는 데 적합하고, Update는 특정 행을 찾아 수정하는 데 맞는다. Append or Update는 기준 컬럼이 명확할 때는 편하지만, 키 설계를 대충 해두면 나중에 어떤 행이 갱신되고 어떤 행이 새로 생기는지 헷갈리기 쉬워진다.

예를 들어 문의 폼 기록, 주문 로그, 일별 수집 데이터처럼 누적형이면 Append가 더 자연스럽다. 반면 고객 상태, 배송 상태, 승인 여부처럼 기존 행을 계속 갱신해야 하는 구조면 Update나 Append or Update가 더 맞는다. 여기서 제일 자주 틀리는 건, 누적형 데이터에 Update를 억지로 쓰다가 기존 데이터가 덮어써지는 경우다.

4. 중복 데이터 방지 로직 구현

중복 방지는 실무에서 거의 필수다. 폼 제출 재시도, 웹훅 중복 발화, 외부 API의 재전송 때문에 같은 내용이 두 번, 세 번씩 들어오는 건 생각보다 흔하다. 이럴 때는 먼저 기존 시트 데이터를 읽고, 특정 키 컬럼 기준으로 이미 존재하는지 확인한 뒤에만 Append 하도록 짜는 편이 가장 안전하다.

다만 전체 시트를 매번 다 읽는 방식은 곧 느려진다. 실제로는 중복 판단에 필요한 열만 최소 범위로 읽어오고, 이메일·주문번호·문의ID처럼 기준 키를 하나 정해두는 편이 훨씬 낫다. “중복 체크는 나중에 넣지 뭐” 하고 미루면 시트 정리가 훨씬 귀찮아진다. 이건 정말 그렇다.

5. 에러 핸들링과 로깅 강화

시트 구조는 생각보다 자주 바뀐다. 열 이름이 바뀌거나, 시트 탭 이름이 바뀌거나, 담당자가 직접 열 순서를 움직여버리는 경우도 있다. 자동화는 멀쩡한데 사람이 중간에 시트를 고쳐버려서 깨지는 경우가 진짜 많다. 그래서 Google Sheets 연동은 “처음 연결할 때”보다 “운영 중 바뀌었을 때”가 더 중요하다.

이럴 때는 Error Trigger 기반으로 슬랙이나 이메일 알림을 붙여두는 편이 좋다. 또 정상 실행 시에도 처리 건수, 대상 시트명, 마지막 성공 시각 정도는 로그처럼 남겨두면 나중에 문제를 훨씬 빨리 찾을 수 있다. 자동화는 결국 성공보다 실패했을 때 얼마나 빨리 알아차리느냐가 더 중요하다.

6. 성능 최적화 팁

대량 데이터 처리에서는 한 번에 너무 많은 행을 읽고 쓰지 않는 편이 낫다. 시트는 데이터베이스보다 훨씬 유연하지만, 반대로 대량 처리에서는 쉽게 느려진다. n8n에서 Loop Over Items(Split in Batches) 같은 구조를 써서 50~100건 단위로 나누면 체감 안정성이 좋아진다.

그리고 가능하면 열 전체를 다 읽어오지 말고, 필요한 열만 최소 범위로 가져오는 편이 훨씬 빠르다. 예를 들어 중복 체크가 이메일 컬럼만 필요하다면 A:A 정도만 읽고, 상태값 확인이 필요하면 A:C 정도로 제한하는 식이다. 단순한 최적화처럼 보이지만, 시트가 수천 행을 넘기기 시작하면 이 차이가 꽤 크게 느껴진다.

직접 확인해보면 좋은 테스트 예시

구글 시트 연동 글은 “연결할 수 있다”만 적어두면 금방 얕아 보인다. 실제로는 어떤 테스트를 해봤는지가 훨씬 중요하다. 아래처럼 일부러 상황을 나눠 확인해보면, 어디서 연동이 꼬이는지 금방 드러난다.

1. 편집 권한 테스트

댓글 예시가 아니라 입력 예시

테스트 데이터:
이름: 홍길동
이메일: [email protected]
상태: 신규

기대 결과
Append Row 실행 시 새 행이 정확히 추가되어야 한다.

실제 확인 포인트
연결된 계정이 시트에 편집 권한을 가지고 있는지, 서비스 계정이라면 해당 계정이 공유 대상에 들어가 있는지 확인한다.

2. 시트 이름과 범위 테스트

입력 예시

시트 이름: 주문 내역
범위: '주문 내역'!A2:D

기대 결과
시트 이름에 공백이 있어도 정확히 인식되어야 한다.

실제 확인 포인트
따옴표 누락 시 오류가 나는지, 숨김 시트이거나 탭 이름이 바뀐 건 아닌지, 문서 ID를 전체 URL로 잘못 넣지 않았는지 본다.

3. 중복 방지 테스트

입력 예시

기준 컬럼: 이메일
기존 데이터: [email protected] 존재
새 입력: [email protected] 다시 들어옴

기대 결과
중복으로 판정되어 새 행이 추가되지 않거나, 필요하면 기존 행만 갱신되어야 한다.

실제 확인 포인트
전체 시트를 매번 읽는지, 필요한 열만 읽는지, 키 컬럼이 공백 없이 일관되게 들어오는지 확인한다.

4. 열 매핑 테스트

입력 예시

입력 객체:
name: 홍길동
email: [email protected]
status: 신규

기대 결과
이름, 이메일, 상태가 의도한 열에 정확히 들어가야 한다.

실제 확인 포인트
시트의 헤더 순서가 바뀌지 않았는지, 사람이 직접 열을 추가하거나 위치를 변경하지 않았는지, Append 시 값 순서가 밀리지 않는지 확인한다.

실제 검증 실행 결과

실제 검증 기준으로 보면, 인증 자체보다 더 자주 문제를 만든 건 권한과 열 매핑이었다. OAuth 연결은 성공으로 떠도, 편집 권한이 없는 계정이면 실제 쓰기 단계에서 바로 막혔고, 서비스 계정은 JSON 키만 넣는다고 끝나는 게 아니라 시트 공유까지 정확히 해야 했다. 또 Append는 잘 되는데 값이 자꾸 엉뚱한 열로 들어가는 경우는 대부분 시트 헤더 구조를 사람이 중간에 바꿔둔 상태에서 계속 같은 매핑을 쓰고 있어서 생겼다. 중복 방지는 전체 시트를 무작정 읽는 방식보다 기준 컬럼만 좁혀 읽는 쪽이 훨씬 안정적이었고, 이 차이는 데이터가 쌓일수록 더 크게 느껴졌다. 결국 구글 시트 연동의 핵심은 API 연결보다 먼저, 누가 이 시트를 쓸지와 어떤 열 구조를 기준으로 유지할지를 고정하는 데 있었다.

테스트 항목입력 예시정상 결과
편집 권한OAuth 계정 또는 서비스 계정읽기뿐 아니라 쓰기까지 정상 동작
시트 이름/범위‘주문 내역’!A2:D공백 있는 시트명도 정확히 인식
중복 방지동일 이메일 재입력새 행 중복 생성 없이 제외 또는 갱신
열 매핑name/email/status 객체의도한 열에 정확히 기록

FAQ: 자주 묻는 질문

Q. n8n에서 구글 스프레드시트 연동 시 ‘API not enabled’ 오류가 발생합니다. 어떻게 해결해야 하나요?

A. Google Cloud Console에서 Google Sheets API가 프로젝트에 활성화되어 있는지 먼저 확인해야 한다. OAuth 클라이언트나 서비스 계정을 만들었더라도 API가 꺼져 있으면 실제 호출은 실패할 수 있다. 변경 후 반영까지 약간의 시간이 걸릴 수 있으니, 바로 안 된다고 해서 설정이 틀렸다고 단정하지 않는 편이 좋다.

Q. 공유된 팀 시트에 n8n이 접근하지 못한다고 나오는데 이유가 뭔가요?

A. 시트를 보고 있는 계정과 n8n에 연결한 계정이 다를 가능성이 크다. 서비스 계정을 쓴다면 서비스 계정 이메일 자체를 시트 공유 대상에 편집자로 넣어야 하고, 조직 정책상 외부 앱 접근이 제한된 경우 관리자 승인도 필요할 수 있다.

Q. n8n으로 구글 시트에 한글을 입력하면 글자가 깨집니다.

A. 보통은 구글 시트 인코딩 문제가 아니라, 앞단 데이터가 이미 깨진 상태로 들어오는 경우가 더 많다. Set 노드나 Code 노드에서 실제 들어오는 문자열을 먼저 확인하고, 외부 API 응답이나 웹훅 입력 단계부터 어디서 깨졌는지 추적해보는 편이 낫다.

Q. Append만 쓰면 되는 거 아닌가요?

A. 초기에는 Append만으로도 충분할 수 있다. 다만 중복 방지, 기존 상태값 갱신, 특정 행 재사용이 필요한 순간부터는 Update나 Append or Update를 같이 봐야 한다. 누적형 데이터인지, 갱신형 데이터인지 먼저 구분하는 게 중요하다.


자동화는 단순히 복붙 시간을 줄이는 데서 끝나지 않는다. 같은 구조의 실수를 줄이고, 사람이 정말 봐야 할 예외만 남기고, 반복 입력 때문에 집중이 끊기는 일을 덜어주는 쪽에 더 가깝다. n8n과 구글 스프레드시트 연동도 결국은 그 흐름 안에 있다.

독자 입장에서 바로 체감되는 이득도 분명하다. 문의나 리드, 주문, 로그 데이터를 손으로 옮기지 않아도 되고, 시트 정리 실수도 줄일 수 있다. 다만 그 전제는 “연결만 되면 끝”이 아니라, 인증과 열 구조, 중복 기준까지 같이 설계해야 한다는 점이다.

그래서 가장 현실적인 출발은 이렇다. 먼저 OAuth 또는 서비스 계정 중 실행 계정을 분명히 정하고, 그다음 Append로 최소 흐름을 붙인 뒤, 마지막에 중복 방지와 실패 알림을 추가하는 식이다. 이 순서로 가면 훨씬 덜 꼬인다.

직접 여러 번 붙여보니, 구글 시트 연동은 생각보다 기술 문제보다 운영 문제에 더 가까웠다. 누가 시트를 바꾸는지, 어떤 열을 기준으로 쓸지, 사람이 중간에 구조를 건드릴 수 있는지를 먼저 정해두는 쪽이 훨씬 오래 버텼다.

다음 단계

이 글을 읽고 바로 적용해보려면, 우선 한 개의 테스트 시트를 만들고 편집 권한이 분명한 계정으로 Append Row만 먼저 성공시키는 것부터 시작하면 된다. 그 다음에야 중복 체크, 상태값 업데이트, 실패 알림을 차례대로 붙이는 편이 훨씬 안전하다.

학습 순서도 비슷하다. 먼저 기본 시트 연동을 붙이고, 이후 웹훅 입력 구조와 외부 데이터 흐름을 정리하고, 마지막으로 보안과 업데이트·백업까지 묶어보는 식이다. 같은 n8n 자동화라도 시트 연동은 “처음 한 줄 기록”보다 “나중에도 안 망가지는 구조”가 훨씬 중요하다.

참고 자료: n8n 공식 Google Sheets 노드 문서 | n8n 공식 Google Credentials 문서 | Google Sheets API 공식 문서

Eddy Glen
Eddy Glen

Eddy Glen은 n8n 자동화와 워드프레스 연동, API 기반 업무 자동화를 중심으로 콘텐츠를 운영합니다. 이 사이트에서는 설치, 업데이트, 오류 해결, 실전 적용 과정에서 자주 막히는 지점을 중심으로 글을 정리하며, 공식 문서와 실제 적용 흐름을 함께 검토해 내용을 구성합니다.

기사 : 72

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다