엑셀 파일 전송은 그만! 파이썬으로 구글 스프레드시트 실시간 업데이트하기

 

지금까지 우리는 파이썬으로 내 컴퓨터(로컬)에 있는 엑셀 파일을 읽고 쓰는 방법을 배웠습니다. 하지만 실무에서는 치명적인 단점이 하나 있습니다. 완성된 .xlsx 파일을 매번 팀원들에게 이메일이나 메신저로 '전송'해야 한다는 점입니다. 만약 데이터가 수정되면 "최종보고서_진짜최종_v2.xlsx" 같은 파일들이 무한히 증식하게 되죠.

이 문제를 완벽하게 해결해 주는 것이 바로 클라우드 기반의 구글 스프레드시트(Google Sheets)입니다. 링크 하나만 공유하면 전 팀원이 항상 최신 데이터를 볼 수 있습니다. 그렇다면 파이썬으로 내가 만든 피벗 테이블이나 크롤링한 데이터를 구글 스프레드시트에 알아서 입력하게 만들 수는 없을까요? '구글 API'를 사용하면 가능합니다!


1. 파이썬에게 구글 출입증(JSON 키) 쥐여주기

파이썬이 내 구글 계정에 함부로 접속해서 시트를 건드리면 안 되기 때문에, 구글에서 정식으로 '서비스 계정(가상의 로봇 계정)'을 만들고 출입증을 발급받아야 합니다.

  1. 구글 클라우드 콘솔에 접속하여 새 프로젝트를 만듭니다.
  2. 'API 및 서비스'에서 Google Drive API와 Google Sheets API를 찾아 '사용 버튼'을 눌러 활성화합니다.
  3. '사용자 인증 정보' 메뉴에서 '서비스 계정'을 생성하고, JSON 형식의 키 파일을 다운로드합니다. 이 파일이 바로 파이썬의 출입증입니다.
  4. 이 JSON 파일의 이름을 google_key.json으로 바꾸고 파이썬 코드가 있는 폴더에 넣어줍니다.

2. 스프레드시트 공유 권한 열어주기

이 부분이 가장 많이 하는 실수입니다. 다운로드한 JSON 파일을 메모장으로 열어보면 client_email 항목에 아주 긴 가상의 이메일 주소(예: bot-123@project.iam.gserviceaccount.com)가 있습니다.

파이썬이 데이터를 쓸 구글 스프레드시트를 웹 브라우저에서 띄운 뒤, 우측 상단의 [공유] 버튼을 누르고 방금 본 가상 이메일 주소를 '편집자' 권한으로 초대해 주어야 합니다. 그래야 파이썬 봇이 해당 문서에 글을 쓸 수 있습니다.


3. 실전 코드: 파이썬으로 시트에 데이터 꽂아 넣기

코드를 실행하기 전 터미널 창에 pip install gspread oauth2client를 입력하여 구글 API 통신용 도구를 설치해 줍니다.

import gspread
from oauth2client.service_account import ServiceAccountCredentials
import pandas as pd

# 1. 구글 API 출입증 인증 세팅
scope = ['https://spreadsheets.google.com/feeds', 'https://www.googleapis.com/auth/drive']
creds = ServiceAccountCredentials.from_json_keyfile_name('google_key.json', scope)
client = gspread.authorize(creds)

# 2. 데이터를 입력할 구글 스프레드시트 파일 이름으로 열기
# (브라우저에서 공유해둔 파일의 정확한 이름을 적어주세요)
doc = client.open('실시간_매출보고서')

# 3. 첫 번째 시트(워크시트) 선택
sheet = doc.sheet1

# 4. 시트에 데이터 업데이트하기 (예: A1 셀부터 판다스 표 밀어넣기)
# (앞선 시리즈에서 만든 피벗 테이블 df가 있다고 가정)
df = pd.DataFrame({'부서명': ['영업1팀', '영업2팀'], '매출액': [500, 700]})

# 데이터프레임을 리스트 형태로 변환하여 구글 시트 양식에 맞춤
sheet.update([df.columns.values.tolist()] + df.values.tolist())

print("구글 스프레드시트 실시간 업데이트 완료!")

이 코드를 실행하고 구글 스프레드시트 창을 띄워놓고 지켜보세요. 마우스와 키보드에 손을 대지 않았는데도 빈 셀들에 글자가 다다닥 채워지는 마법 같은 광경을 목격할 수 있습니다.


클라우드와 파이썬의 만남, 진정한 대시보드 구축

이제 여러분이 19편에서 세팅한 '새벽 6시 스케줄러'가 돌 때마다, 엑셀 파일이 컴퓨터에 저장되는 것을 넘어 팀 전체가 보고 있는 구글 스프레드시트가 실시간으로 갱신됩니다. 여러분은 복잡하게 메일을 쏠 필요도 없이 "팀장님, 아침마다 즐겨찾기 해두신 구글 시트 링크만 새로고침 하시면 됩니다"라고 멋지게 말씀하시면 됩니다. 파이썬으로 사내 전용 실시간 대시보드를 구축하신 겁니다!


▶ 핵심 요약

  • 파이썬으로 구글 스프레드시트를 제어하려면 구글 클라우드 콘솔에서 API를 활성화하고 '서비스 계정 JSON 키'를 발급받아야 합니다.
  • 서비스 계정의 가상 이메일을 작업하려는 구글 스프레드시트에 '편집자'로 반드시 초대(공유)해야 권한 오류가 나지 않습니다.
  • gspread 라이브러리를 사용하면 판다스의 데이터프레임이나 리스트 형태의 데이터를 웹상의 시트에 실시간으로 밀어 넣을 수 있습니다.

엑셀, 이메일, 메신저, 구글 시트까지... 이제 실무에서 쓰는 거의 모든 도구를 자동화했습니다. 다음 편에서는 대망의 '웹 브라우저 마우스/키보드 자동 조작 (Selenium)'을 통해, 사내 인트라넷 로그인이나 ERP 시스템 클릭까지 파이썬에 맡겨버리는 궁극의 기술을 만나보겠습니다.


여러분의 회사에서는 로컬 엑셀 파일(.xlsx)과 구글 스프레드시트 중 어느 것을 더 자주 활용하시나요? 클라우드 문서를 도입했을 때 가장 편리했던 점은 무엇이었는지 댓글로 남겨주세요!



댓글

댓글 쓰기

이 블로그의 인기 게시물

엑셀로는 안 열리는 200만 행 대용량 데이터, 파이썬으로 1초 만에 요약하기

 회사에서 수년간 누적된 판매 데이터나 웹사이트 로그 데이터를 다운로드해 본 적 있으신가요? 파일 용량이 500MB를 넘어가고, 엑셀로 더블클릭해서 열었더니 화면 상단에 "데이터가 너무 많아 완전히 로드되지 않았습니다"라는 무시무시한 경고창이 뜹니다. 스크롤을 맨 밑으로 내려보면 정확히 1,048,576행에서 데이터가 싹둑 잘려 있습니다. 엑셀이라는 프로그램이 태생적으로 담을 수 있는 최대 한계치가 약 104만 행이기 때문입니다. 그 이상의 데이터는 엑셀로는 아예 열어볼 수조차 없습니다. 결국 데이터를 월별로 쪼개서 다운받는 등 불필요한 노가다를 해야 하죠. 하지만 파이썬에게 데이터의 한계란 '컴퓨터 메모리(RAM)의 한계'일 뿐입니다. 오늘은 엑셀은 쳐다보지도 못하는 200만 행, 1,000만 행의 대용량 데이터를 파이썬으로 가볍게 다루는 심화 기술을 알아보겠습니다. 1. 대용량 데이터의 표준, CSV 파일 불러오기 보통 100만 행이 넘어가는 대용량 데이터는 .xlsx 포맷이 아니라 .csv 포맷으로 저장되어 있습니다. CSV는 서식 없이 콤마(,)로만 데이터를 구분한 순수 텍스트 파일이라 용량이 훨씬 가볍기 때문입니다. 판다스에서 CSV 파일을 불러오는 방법은 엑셀과 거의 똑같습니다. read_excel 대신 read_csv 만 써주면 됩니다. import pandas as pd df = pd.read_csv('3년치_전체판매로그.csv') 엑셀이 열다가 기절해버린 200만 행짜리 파일도, 파이썬에서는 위 코드 한 줄이면 단 몇 초 만에 데이터 프레임(표)으로 변환되어 메모리에 척척 올라갑니다. 이제 13편에서 배웠던 피벗 테이블 코드를 돌리면 200만 행의 데이터도 순식간에 요약할 수 있습니다. 2. 컴퓨터가 멈춘다면? 마법의 옵션 chunksize 파이썬이 아무리 강력해도, 내 컴퓨터의 램(RAM) 메모리가 8GB밖에 안 되는데 10GB짜리 초거대 데이터를 한 번에 불러오려 ...
자세한 내용 보기

수식이 걸린 엑셀 데이터, 파이썬으로 불렀더니 NaN이 뜨는 이유와 해결법

실무에서 사용하는 엑셀 파일은 단순한 숫자의 나열이 아닙니다. 단가와 수량을 곱하는 간단한 수식부터, 복잡한 조건부 합계(SUMIFS)까지 다양한 수식들이 거미줄처럼 얽혀있죠. 파이썬 자동화를 처음 배우시는 분들은 이 수식이 걸린 엑셀 파일을 판다스로 호기롭게 불러왔다가, 숫자가 있어야 할 자리에 'NaN(빈칸)'이 가득한 것을 보고 멘붕에 빠지곤 합니다. "엑셀을 열면 분명히 숫자가 잘 보이는데, 왜 파이썬은 빈칸이라고 할까요?" 이것은 파이썬에 에러가 난 것이 아니라, 엑셀과 파이썬이 '수식'을 대하는 근본적인 방식이 다르기 때문입니다. 오늘은 이 치명적인 오류의 원인을 파헤치고, 진정한 의미의 '데이터 자동화'를 위해 수식을 어떻게 다뤄야 하는지 그 해답을 제시해 드립니다. 1. 파이썬은 엑셀의 수식을 '계산'하지 못합니다 가장 먼저 머릿속에 박아두어야 할 핵심 개념입니다. 판다스(Pandas)는 엑셀 프로그램이 아닙니다. 따라서 SUM , VLOOKUP 같은 엑셀 고유의 함수 엔진을 가지고 있지 않습니다. 우리가 pd.read_excel() 로 파일을 불러올 때, 파이썬은 엑셀 파일의 껍데기를 살짝 들춰보고 '가장 마지막에 엑셀이 계산해 둔 결과값(캐시 데이터)'만을 사진 찍듯이 찰칵 찍어옵니다. 즉, 파이썬 안에서 수량 데이터를 10에서 20으로 바꾼다고 해서, 총합계 수식이 자동으로 업데이트되어 바뀌지 않는다는 뜻입니다. 파이썬이 가져온 것은 살아 숨 쉬는 수식이 아니라 '박제된 숫자 텍스트'일 뿐입니다. 2. ERP에서 다운받은 파일이 무조건 NaN을 뱉는 이유 그런데 왜 숫자가 안 나오고 NaN이 뜨는 걸까요? 보통 회사 사내 시스템(ERP 등)에서 다운로드한 엑셀 파일에서 이런 일이 잦습니다. 시스템이 엑셀 파일을 만들어낼 때는 컴퓨터의 리소스를 아끼기 위해 수식(예: =A1*B1 )만 텍스트로 적어놓고, 실제 결과값은 계산하지 않은 채(...
자세한 내용 보기

"파일을 찾을 수 없습니다" - 경로 오류(Path error)가 발생하는 이유와 대처법

파이썬으로 엑셀 자동화 코드를 잘 짜놓고 기분 좋게 실행했는데, 화면 가득 빨간색 글씨로 FileNotFoundError 가 뜨면 누구나 당황하기 마련입니다. 분명히 내 눈앞 폴더에 파일이 있는데 파이썬은 "파일을 찾을 수 없다"고 우기니 답답할 노릇이죠. 어제까지 잘 되던 코드가 오늘 폴더 이름 하나 바꿨다고 멈춰버리는 일도 허다합니다. 우리가 윈도우 탐색기에서 마우스로 폴더를 클릭해 들어가는 방식은 직관적이지만, 파이썬에게 위치를 알려줄 때는 조금 더 정교한 규칙이 필요합니다. 오늘은 초보자들이 가장 많이 헤매는 '경로(Path)'의 원리를 이해하고, 매일 바뀌는 업무 환경에서도 에러 없이 파일을 척척 찾아내는 스마트한 경로 설정법을 알아보겠습니다. 1. 파이썬이 파일을 찾는 기준: 절대 경로 vs 상대 경로 파이썬이 파일을 찾는 방식은 크게 두 가지입니다. 첫째는 '절대 경로'입니다. 주소창 전체를 복사하는 방식이죠. 예컨대 C:\Users\Desktop\보고서.xlsx 처럼 집 주소를 처음부터 끝까지 다 알려주는 것입니다. 가장 확실하지만, 만약 코드를 다른 사람에게 보내거나 폴더 위치를 살짝만 옮겨도 주소가 통째로 틀려져 에러가 발생한다는 단점이 있습니다. 둘째는 '상대 경로'입니다. "지금 내가 있는 곳에서 바로 옆에 있는 파일을 찾아라"라고 명령하는 방식입니다. 파일 주소 대신 ./보고서.xlsx 처럼 마침표( . )를 사용합니다. 마침표 하나는 '현재 폴더'를 의미합니다. 코드가 들어있는 폴더와 엑셀 파일이 같은 곳에 있다면, 폴더 통째로 위치를 옮겨도 에러 없이 작동하기 때문에 실무에서는 상대 경로를 사용하는 것이 훨씬 유지보수에 유리합니다. 2. 내가 지금 어디에 있지? os.getcwd() 확인하기 상대 경로를 썼는데도 에러가 난다면, 파이썬이 생각하는 '현재 위치'와 내가 생각하는 위치가 다르기 때문입니다. 파이썬은 내가 코드를 ...
자세한 내용 보기