[업무자동화] 구글 스프레드시트 API 사용법 (feat. Google Cloud Console)

Google 스프레드시트를 단순한 문서 도구가 아닌, 자동화 가능한 데이터 저장소로 써보고 싶었던 적 있나요?

이 글에서는 Google Cloud Console을 통해 Google Sheets API를 활성화하고,
Python을 이용해 스프레드시트를 읽고 쓰는 방법까지 정리해보았습니다.

---

✅ 1. Google Cloud Console에서 API 설정하기

1-1. Google Cloud Console 접속

https://console.cloud.google.com
구글 계정으로 로그인합니다.

---

1-2. 새 프로젝트 생성

저는 이미 만들어둬서 저렇게 보이는 거예요.
처음이시라면, 빨간색으로 표시된 부분을 눌러서 새 프로젝트를 생성하시면 됩니다.

---

1-3. Google Sheets API 활성화

그리고 상단 검색창에 Google Spreadsheet API를 검색하신 뒤,
나오는 결과에서 사용 버튼을 클릭하시면 됩니다.

---

1-4. 서비스 계정 만들기

이제 프로젝트 설정 메뉴로 들어가 주세요.

서비스 계정 탭에서 서비스 계정을 생성하시면 됩니다.
역할은 Editor 또는 Sheets API Editor 권한으로 설정해주시면 돼요.

---

1-5. 서비스 계정 키(JSON) 생성

방금 만든 서비스 계정을 클릭한 뒤,
왼쪽 메뉴에서 키 탭으로 이동해 키 추가 → 새 키 생성을 선택해주세요.

JSON 형식을 선택하면 자동으로 파일이 다운로드됩니다.
이 JSON 파일은 나중에 Google API를 사용할 때 인증용으로 필요하니 잘 보관해두세요.

---

1-6. 스프레드시트 공유 설정

https://workspace.google.com/intl/ko/products/sheets/

Google Sheets: 온라인 스프레드시트 & 템플릿 | Google Workspace

이제 Google 스프레드시트로 이동해서 새로운 스프레드시트를 하나 만들어주세요.

이 시트는 Python 코드에서 데이터를 읽고 쓰게 될 대상이에요.

스프레드시트를 만들었다면, 오른쪽 상단의 공유 버튼을 눌러주세요.

그리고 이전에 만든 Google Cloud Console의 서비스 계정 이메일을 추가한 뒤,
편집자 권한으로 설정해주시면 됩니다.

이 과정을 통해 Python 코드에서 해당 시트에 접근하고 수정할 수 있게 됩니다.

---

✅ 2. Python에서 Google Sheets API 사용하기

2-1. 필요한 패키지 설치

pip install gspread oauth2client

이제 Python에서 Google Sheets API를 사용하기 위해 필요한 패키지를 설치하시면 됩니다.

---

2-2. 코드 예시 (읽기/쓰기)

import gspread
from oauth2client.service_account import ServiceAccountCredentials

# 인증 범위
scope = [
    "https://spreadsheets.google.com/feeds",
    "https://www.googleapis.com/auth/drive"
]

# JSON 키 파일로 인증
creds = ServiceAccountCredentials.from_json_keyfile_name("your-key.json", scope)
client = gspread.authorize(creds)

# 스프레드시트 열기
sheet = client.open("구글스프레드시트명").worksheet("Sheet1")

# 데이터 쓰기
sheet.update("A1", "Hello, Google Sheets!")

# 데이터 읽기
value = sheet.acell("A1").value
print("셀 A1의 값:", value)

 

서비스 계정의 JSON 키 파일로 인증한 뒤, 원하는 구글 스프레드시트를 열 수 있습니다.
이후 Python 코드로 셀에 데이터를 쓰고 읽는 작업이 가능해지며,
여기서 사용하는 JSON 파일은 앞서 1~5단계에서 발급받은 서비스 계정 키 경로를 그대로 사용하면 됩니다.

 

---

📝 마무리

이처럼 Google Spreadsheet API를 활용하면 Python에서 시트를 자유롭게 조작할 수 있습니다.
잘만 활용하면 반복적인 업무를 자동화하는 데 큰 도움이 될 거예요. 😎