구글 스프레드시트, 파이썬으로 자동으로 읽고 쓰기

구글 스프레드시트, 파이썬으로 자동으로 읽고 쓰기 (완성 코드 공개)

파이썬으로 구글 스프레드시트 데이터를 자동으로 읽고 쓰는 모습


"팀원들이 각자 구글 시트에 입력한 데이터를 매일 아침 취합해서 정리해야 하는데…", "웹에서 수집한 데이터를 구글 시트에 자동으로 업데이트하면 좋겠는데…"

구글 스프레드시트는 팀 협업에 편리하지만, 데이터를 매번 손으로 입력하거나 다른 파일에서 복사해 붙여넣는 작업은 번거롭고 실수가 납니다. 파이썬을 한 번만 세팅해두면 구글 시트의 데이터를 자동으로 읽어오고, 원하는 내용을 자동으로 입력하고, 기존 데이터를 업데이트하는 것까지 모두 처리할 수 있습니다.

1단계: 구글 API 설정 (최초 1회만)

파이썬에서 구글 스프레드시트에 접근하려면 구글 클라우드에서 API 키를 발급받아야 합니다. 아래 순서대로 진행하세요.

  1. Google Cloud Console(console.cloud.google.com)에 접속해 구글 계정으로 로그인합니다.
  2. 상단 "프로젝트 선택" → "새 프로젝트" 클릭 → 프로젝트 이름(예: "파이썬자동화") 입력 후 만들기
  3. 왼쪽 메뉴 "API 및 서비스" → "라이브러리" 클릭
  4. 검색창에 "Google Sheets API" 검색 → 클릭 → "사용 설정"
  5. 같은 방법으로 "Google Drive API"도 검색해서 "사용 설정"
  6. 왼쪽 메뉴 "API 및 서비스" → "사용자 인증 정보" → "사용자 인증 정보 만들기" → "서비스 계정" 선택
  7. 서비스 계정 이름 입력(예: "sheets-bot") → 만들기 → 완료
  8. 생성된 서비스 계정 클릭 → "키" 탭 → "키 추가" → "JSON" 선택 → 다운로드

다운로드한 JSON 파일을 credentials.json으로 이름을 바꾸고 코드 파일과 같은 폴더에 저장합니다.

⚠️ 마지막 설정: 자동화할 구글 스프레드시트를 열고 오른쪽 상단 "공유" 버튼 클릭 → JSON 파일 안의 "client_email" 값(xxxx@xxxx.iam.gserviceaccount.com 형태)을 복사해서 편집자 권한으로 공유합니다. 이 설정이 없으면 파이썬에서 접근이 거부됩니다.

2단계: 준비물 설치

터미널(윈도우: CMD 또는 파워셸)을 열고 아래 명령어를 실행하세요:

pip install gspread google-auth pandas

gspread는 파이썬에서 구글 스프레드시트를 다루는 전용 라이브러리입니다. google-auth는 1단계에서 발급한 JSON 키로 구글 API에 인증하는 라이브러리이고, pandas는 데이터를 표 형태로 처리하는 데 사용합니다.

3단계: 완성 코드

아래 코드를 그대로 복사해서 메모장에 붙여넣고, gsheet_auto.py로 저장하세요. 저장 시 파일 형식은 "모든 파일", 인코딩은 UTF-8로 설정합니다. credentials.json 파일과 같은 폴더에 저장해야 합니다.

import gspread
from google.oauth2.service_account import Credentials
import pandas as pd
from datetime import datetime

# ① 설정
CREDENTIALS_FILE = "credentials.json"            # ← JSON 키 파일명
SPREADSHEET_NAME = "팀 업무 현황"                 # ← 구글 시트 제목 (정확히 일치해야 함)
SHEET_NAME       = "Sheet1"                       # ← 시트 탭 이름

# ② 구글 API 인증
SCOPES = [
    "https://www.googleapis.com/auth/spreadsheets",
    "https://www.googleapis.com/auth/drive",
]
creds  = Credentials.from_service_account_file(CREDENTIALS_FILE, scopes=SCOPES)
client = gspread.authorize(creds)
print("  ✔ 구글 API 인증 완료")

# ③ 시트 열기
spreadsheet = client.open(SPREADSHEET_NAME)
sheet       = spreadsheet.worksheet(SHEET_NAME)
print(f"  ✔ 시트 열기 완료: '{SPREADSHEET_NAME} > {SHEET_NAME}'")

# ④ 데이터 읽기 (전체)
all_data = sheet.get_all_records()   # 1행(헤더) 기준으로 딕셔너리 리스트 반환
df = pd.DataFrame(all_data)
print(f"  ✔ 데이터 읽기 완료: {len(df)}행 × {len(df.columns)}열")
print(df.head())   # 상위 5행 미리보기

# ⑤ 새 행 추가 (시트 맨 아래에 추가)
new_row = [
    datetime.now().strftime("%Y-%m-%d"),   # 날짜
    "신규 거래처",                           # 거래처명
    "홍길동",                               # 담당자
    1500000,                               # 금액
    "진행중",                               # 상태
]
sheet.append_row(new_row)
print(f"  ✔ 새 행 추가 완료: {new_row}")

# ⑥ 특정 셀 업데이트 (B2 셀을 수정하는 예시)
sheet.update("B2", "업데이트된 값")
print(f"  ✔ B2 셀 업데이트 완료")

print(f"\n✅ 완료! 구글 시트 자동화 성공")

4단계: 실행 방법

  1. 코드 ① 설정의 SPREADSHEET_NAME에 자동화할 구글 시트 제목을 정확히 입력합니다. 대소문자·공백까지 일치해야 합니다.
  2. SHEET_NAME에 탭 이름을 입력합니다. 기본값은 "Sheet1"이지만, 탭 이름을 변경했다면 변경된 이름을 입력합니다.
  3. 코드 ⑤의 new_row 내용을 본인 시트 열 구조에 맞게 수정합니다.
  4. 터미널에서 아래 명령어로 실행합니다:
python gsheet_auto.py

정상 실행 시 터미널에 이렇게 출력됩니다:

  ✔ 구글 API 인증 완료
  ✔ 시트 열기 완료: '팀 업무 현황 > Sheet1'
  ✔ 데이터 읽기 완료: 15행 × 5열
     날짜        거래처명   담당자   금액      상태
  0  2026-05-01  A주식회사  홍길동  5200000   완납
  1  2026-05-03  B연구소    김철수   980000   미납
  ...
  ✔ 새 행 추가 완료: ['2026-05-29', '신규 거래처', '홍길동', 1500000, '진행중']
  ✔ B2 셀 업데이트 완료

✅ 완료! 구글 시트 자동화 성공

5단계: 자주 발생하는 오류와 해결법

오류 1: SpreadsheetNotFound

구글 시트 제목이 코드와 다르거나, 서비스 계정 이메일로 시트를 공유하지 않은 경우입니다. 1단계 마지막 설정에서 client_email 값으로 시트를 편집자 권한으로 공유했는지 다시 확인하세요.

오류 2: APIError 429 (Too Many Requests)

구글 Sheets API는 1분에 60회 요청 제한이 있습니다. 반복문 안에서 셀을 한 개씩 업데이트하면 금방 한도를 초과합니다. 여러 셀을 한꺼번에 업데이트할 때는 sheet.update()에 2차원 배열을 한 번에 넘기세요:

sheet.update("A2:C4", [["값1", "값2", "값3"], ["값4", "값5", "값6"]])

오류 3: DefaultCredentialsError

credentials.json 파일이 코드 파일과 같은 폴더에 없는 경우입니다. 두 파일이 같은 폴더 안에 있는지 확인하거나, CREDENTIALS_FILE에 JSON 파일의 전체 경로를 입력하세요.

응용: 구글 시트 데이터를 읽어 엑셀로 백업하고 싶다면

구글 시트 데이터를 로컬 엑셀 파일로 자동 백업하는 코드입니다. 코드 ④ 읽기 아래에 추가하세요.

from pathlib import Path

BACKUP_PATH = r"C:\Users\내이름\Desktop\시트백업.xlsx"   # ← 백업 파일 경로

df.to_excel(BACKUP_PATH, index=False)
print(f"  ✔ 엑셀 백업 완료 → {BACKUP_PATH}")
💡 이전 게시글과 결합하면: 웹 데이터 자동 수집 편으로 수집한 데이터를 구글 시트에 자동으로 입력하거나, 주식·환율 자동 수집 편의 데이터를 팀 공유 시트에 매일 자동 업데이트하는 것도 가능합니다.

핵심 요약

  • 준비물: 구글 클라우드 API 설정(최초 1회) + pip install gspread google-auth pandas
  • 설정: credentials.json을 코드와 같은 폴더에 저장 + 시트를 서비스 계정 이메일로 공유
  • 실행: 터미널에서 python gsheet_auto.py 입력
  • 결과: 구글 시트 데이터 읽기·새 행 추가·셀 업데이트 자동 처리

이 코드를 응용하면 여러 시트를 순서대로 처리하거나, 조건에 따라 특정 행의 색상을 자동으로 변경하는 것도 가능합니다.

이 블로그의 인기 게시물

카카오톡 용량 줄이기! 대화방 파일 삭제로 스마트폰 용량 확보법 (1분 해결)

이미지
  카카오톡 용량 줄이기! 대화방 파일 삭제로 스마트폰 용량 확보법 (1분 해결) 내 스마트폰 용량을 좀먹는 주범, 카카오톡 스마트폰을 오래 사용하다 보면 어느 순간 '저장공간 부족' 알림이 뜨면서 사진을 찍거나 앱을 업데이트할 수 없는 답답한 상황을 맞게 됩니다. 불필요한 사진과 앱을 지워보지만, 용량은 좀처럼 늘어나지 않습니다. 이때 가장 먼저 의심해 봐야 할 주범이 바로 국민 메신저 '카카오톡'입니다. 카카오톡은 수많은 대화방에서 주고받는 수십, 수백 장의 사진과 동영상, 파일들을 스마트폰의 임시 저장소(캐시)에 쌓아둡니다. 이 데이터들이 수개월, 수년 동안 쌓이면 수 GB(기가바이트)에서 많게는 수십 GB까지 차지하게 되어 스마트폰 전체 속도를 늦추고 용량을 고갈시킵니다. 하지만 중요한 대화 내용을 유지하면서도 불필요한 찌꺼기 파일만 골라내어 스마트폰 용량을 획기적으로 확보하는 방법이 있습니다. 오늘은 초보자도 1분 만에 따라 할 수 있는 카카오톡 용량 줄이기의 핵심 방법 2가지를 상세히 알아보겠습니다. 전체 대화방 캐시 데이터 한 번에 삭제하기 (가장 확실한 효과) 카카오톡 설정 메뉴에는 각 대화방에 쌓여있는 임시 파일들을 한꺼번에 정리해 주는 아주 유용한 기능이 있습니다. 이 기능을 활용하면 텍스트 대화 내용은 그대로 유지하면서, 예전에 주고받았던 (지금은 볼 수 없는) 사진이나 동영상 데이터만 삭제하여 가장 큰 용량 확보 효과를 볼 수 있습니다. 카카오톡 앱을 실행한 후, 화면 우측 하단의 **[더보기(...) 아이콘]**을 클릭합니다. 우측 상단의 **[설정(톱니바퀴) 아이콘]**을 누릅니다. [데이터 및 저장공간 관리] 메뉴로 들어갑니다. (아이폰의 경우 [설정 > 기타 > 저장공간 관리] 순서) 화면 윗부분에 보이는 [임시 데이터 삭제] 삭제를 선택합니다.  (하단에 삭제 가능한 용량이 표시됩니다.) 팝업창이 뜨면 **[모두 삭제]**를 누릅니다. 이 기능은 텍스트 대화 내용을 지우지 않으므로 안심하...
자세한 내용 보기

느려진 구글 크롬 속도 2배 빨라지는 3가지 설정 방법 (2026년 최신 가이드)

이미지
  느려진 구글 크롬 속도 2배 빨라지는 3가지 설정 방법 (2026년 최신 가이드) 왜 구글 크롬은 점점 느려지는 걸까요? 전 세계에서 가장 많은 사람들이 사용하는 웹 브라우저인 구글 크롬(Google Chrome)은 직관적인 인터페이스와 뛰어난 호환성을 자랑합니다. 하지만 크롬을 오래 사용하다 보면 어느 순간부터 웹페이지 로딩 속도가 눈에 띄게 느려지거나, 탭을 여러 개 띄웠을 때 컴퓨터 전체가 버벅거리는 현상을 겪게 됩니다. 크롬이 느려지는 가장 큰 원인은 바로 '메모리(RAM) 점유율' 때문입니다. 크롬은 속도와 안정성을 높이기 위해 각 탭마다 별도의 프로세스를 실행하는 구조를 가지고 있는데, 이 때문에 탭을 많이 열어둘수록 컴퓨터의 메모리를 엄청나게 잡아먹는 일명 '램 먹는 하마'가 되어버립니다. 하지만 걱정하지 않으셔도 됩니다. 복잡한 외부 최적화 프로그램이나 백신을 설치할 필요 없이, 크롬 브라우저 내부의 기본 설정 몇 가지만 변경해 주어도 체감 속도를 2배 이상 끌어올릴 수 있습니다. 오늘은 초보자도 1분 만에 따라 할 수 있는 구글 크롬 속도 향상 및 최적화 방법 3가지를 상세히 알아보겠습니다. 크롬 속도 향상을 위한 핵심 설정 3단계 1: 크롬 '메모리 절약 모드' 활성화하기 가장 먼저 적용해야 할 것은 구글 크롬에서 공식적으로 지원하는 '메모리 절약 모드(Memory Saver)'를 켜는 것입니다. 이 기능은 현재 사용하지 않고 배경에 띄워져만 있는 비활성 탭의 메모리를 강제로 확보하여, 현재 내가 보고 있는 활성 탭에 컴퓨터의 자원을 몰아주는 아주 훌륭한 기능입니다. 크롬 브라우저를 실행한 후, 화면 우측 상단에 있는 **세 개의 점 아이콘(Chrome 맞춤설정 및 제어)**을 클릭합니다. 드롭다운 메뉴가 나타나면 하단의 [설정] 메뉴로 들어갑니다. 설정 화면 왼쪽 카테고리 메뉴에서 [성능] 탭을 클릭합니다. 상단에 보이는 '메모리 절약' 항목의 스위치를 클릭하여...
자세한 내용 보기

업무 속도 3배 빨라지는 윈도우 기본 캡처 도구 단축키 및 200% 활용 꿀팁

이미지
  업무 속도 3배 빨라지는 윈도우 기본 캡처 도구 단축키 및 200% 활용 꿀팁 컴퓨터로 문서 작업을 하거나 인터넷 서핑을 하다 보면 화면의 특정 부분을 캡처해야 하는 순간이 매일 찾아옵니다. 과거에는 화면 전체를 복사하는 Print Screen(PrtScn) 키를 누르고 그림판에 붙여넣어 자르거나, 무거운 외부 캡처 프로그램을 따로 설치해서 사용하곤 했습니다. 하지만 윈도우 10과 윈도우 11에는 별도의 프로그램 설치가 전혀 필요 없는 아주 강력하고 편리한 '기본 캡처 도구'가 내장되어 있습니다. 단축키 하나만 외워두면 번거로운 과정 없이 원하는 화면을 1초 만에 잘라내고 공유할 수 있습니다. 오늘은 직장인과 학생들의 업무 및 과제 효율을 극대화해 줄 윈도우 캡처 도구의 핵심 단축키와 숨겨진 활용 꿀팁을 자세히 알아보겠습니다. 가장 완벽한 캡처 단축키: 윈도우키 + Shift + S 복잡한 프로그램을 켤 필요 없이, 지금 키보드에서 **[Windows 로고 키] + [Shift] + [S]**를 동시에 눌러보세요. 즉시 화면이 살짝 어두워지면서 모니터 상단에 4가지 캡처 모드를 선택할 수 있는 작은 메뉴 바가 나타납니다. 이 단축키가 윈도우 캡처의 핵심입니다. 상단 메뉴 바에서는 다음과 같은 4가지 모드를 제공합니다. 사각형 캡처: 마우스를 드래그하여 원하는 영역만 네모 반듯하게 잘라냅니다. 가장 많이 쓰이는 기능입니다. 자유형 캡처: 마우스가 움직이는 궤적을 따라 원하는 모양대로 자유롭게 오려낼 수 있습니다. 창 캡처: 현재 떠 있는 웹 브라우저나 폴더 등 특정 '창' 하나만 깔끔하게 선택하여 캡처합니다. 전체 화면 캡처: 듀얼 모니터를 포함한 모니터 화면 전체를 한 번에 찍습니다. 사각형 캡처를 선택하고 화면의 원하는 부분을 드래그하면, 캡처된 이미지가 자동으로 '클립보드(임시 저장소)'에 복사됩니다. 즉, 별도로 파일 저장을 하지 않아도 카카오톡 대화창이나 워드, 한글 프로그램에 대고 **Ctrl + ...
자세한 내용 보기