Google 스프레드시트는 데이터를 관리하고 분석하며 팀원들과 협업하는 데 강력한 도구입니다. 여기에 Google Sheets API를 연동하면 데이터 입력, 요약 정리, 보고서 생성, 실시간 데이터 동기화 같은 반복 작업을 손쉽게 자동화할 수 있습니다. 이 글에서는 Google Sheets API를 연동하여 업무를 자동화하는 전 과정을 단계별로 소개합니다.
1단계: Google Sheets API 사용 설정
Google Cloud Console에 로그인
- Google Cloud Console 사이트에 접속합니다.
- 본인의 Google 계정으로 로그인합니다.
새 프로젝트 만들기
- 화면 상단 왼쪽(“Google Cloud” 옆)의 프로젝트 드롭다운을 클릭한 뒤 새 프로젝트를 선택합니다.
- 프로젝트 이름을 입력합니다(예: “Google Sheets Automation”).
- 만들기 버튼을 클릭합니다.
API 라이브러리 열기:
- Cloud Console에서 API 및 서비스 >> 라이브러리로 이동합니다.
Google Sheets API 검색:
- 검색창에 Google Sheets API를 입력합니다.
- 해당 API를 클릭한 후 사용(Enable) 버튼을 눌러 활성화합니다.
2단계: API 사용자 인증 정보 설정
- 사용자 인증 정보 페이지 이동
- Cloud Console에서 API 및 서비스 >> 사용자 인증 정보를 선택합니다.
- 사용자 인증 정보 만들기
- 사용자 인증 정보 만들기를 클릭합니다.
- 드롭다운에서 서비스 계정을 선택합니다.
- 서비스 계정 설정
- 서비스 계정의 이름을 입력합니다.
- 완료를 클릭합니다.
- 서비스 계정 키 발급
- 서비스 계정 목록에서 방금 생성한 계정을 클릭합니다.
- 키 탭으로 이동한 뒤 키 추가 >> 새 키 만들기를 선택합니다.
-
- 키 유형은 JSON을 선택하고 만들기를 클릭합니다.
- credentials.json이라는 파일이 다운로드됩니다. 이 파일은 반드시 안전하게 보관하세요.
3단계: 서비스 계정과 Google 스프레드시트 공유
Google 스프레드시트 열기
- 새 스프레드시트를 만들거나 기존 파일을 엽니다.
서비스 계정 이메일과 공유
- Cloud Console로 돌아가 해당 서비스 계정을 찾습니다.
- 서비스 계정의 이메일 주소를 복사합니다.
- 스프레드시트에서 오른쪽 상단의 공유 버튼을 클릭합니다.
- 복사한 서비스 계정 이메일을 붙여넣고 완료를 클릭합니다.
4단계: 필요한 Python 라이브러리 설치
Google Sheets API와 통신하려면 google-auth와 google-api-python-client 라이브러리가 필요합니다.
- 터미널(명령 프롬프트, PowerShell 또는 사용 중인 터미널)을 엽니다.
- 다음 명령어를 실행합니다:
pip install --upgrade google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client
이 명령어를 실행하면 API 작업에 필요한 라이브러리들이 모두 설치됩니다.
5단계: Google Sheets API 인증
Python 스크립트는 어떤 Python 환경에서든 실행할 수 있으며, 여기서는 Visual Studio Code를 사용합니다.
Visual Studio Code 열기:
- credentials.json 파일을 저장한 폴더를 엽니다.
- sheets_api.py라는 이름의 Python 파일을 생성하고 아래 코드를 입력합니다:
from google.oauth2 import service_account
from googleapiclient.discovery import build
# Load credentials from the JSON file
credentials = service_account.Credentials.from_service_account_file(
'credentials.json', # Path to your downloaded credentials.json file
scopes=['https://www.googleapis.com/auth/spreadsheets']
)
# Build the Sheets API service
service = build('sheets', 'v4', credentials=credentials)
print("Google Sheets API is connected!")
- 스크립트를 실행하려면 다음 명령어를 입력합니다.
연결이 정상적으로 완료되면 터미널에 “Google Sheets API is connected!” 메시지가 출력됩니다.
6단계: 작업 자동화
API를 통해 읽기, 쓰기, 추가 등 다양한 작업을 자동화할 수 있습니다.
1. Google 스프레드시트 데이터 읽기
스프레드시트의 데이터를 읽으려면 스크립트에 아래 코드를 추가합니다:
#Read data from Google Sheets
spreadsheet_id = 'your-spreadsheet-id' # Replace with your actual sheet ID
range_name = 'Sheet1!A1:G71' # Specify the range to read
# Retrieve data from the sheet
result = service.spreadsheets().values().get(
spreadsheetId=spreadsheet_id,
range=range_name
).execute()
values = result.get('values', [])
print("Data from Google Sheet:", values)
- 'your-spreadsheet-id' 부분을 실제 Google 스프레드시트 ID로 교체하세요.
- 스프레드시트 ID는 시트 URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/your-spreadsheet-id/edit#gid=0
- 스크립트를 다시 실행하면 터미널에서 불러온 데이터를 확인할 수 있습니다.
2. Google 스프레드시트에 데이터 쓰기
API 연동을 통해 Python 스크립트로 스프레드시트에 직접 데이터를 쓸 수도 있습니다. 데이터를 기록하려면 스크립트에 아래 코드를 추가합니다:
#Write data to the Google Sheet
data = [
['Name', 'Age', 'Department', 'Salary'],
['Alice', 30, 'HR', 60000],
['Bob', 25, 'Engineering', 70000],
['Charlie', 35, 'Sales', 80000],
]
body = {
'values': data
}
service.spreadsheets().values().update(
spreadsheetId=spreadsheet_id,
range='Sheet2!A1',
valueInputOption='RAW',
body=body
).execute()
- 스크립트를 실행하면 Google 스프레드시트에 데이터가 자동으로 반영된 것을 확인할 수 있습니다.
스크립트 실행 일정 자동화하기
스케줄러를 사용해 스크립트를 주기적으로 실행하거나, Apps Script에 트리거를 추가하여 자동 실행되도록 설정할 수 있습니다.
- Windows: 작업 스케줄러(Task Scheduler)를 활용합니다.
- macOS/Linux: cron 잡(cron jobs)을 사용합니다.
자동화 활용 예시:
- 여러 데이터 소스에서 자동으로 데이터를 수집해 매일 요약 보고서를 생성합니다.
- 원시 데이터를 가져와 정제한 후, 가공된 결과를 다시 스프레드시트에 기록합니다.
- 외부 데이터베이스의 데이터를 Google 스프레드시트와 실시간으로 동기화합니다.
마치며
Google Sheets API를 활용하면 반복적인 작업, 데이터 입력, 레코드 업데이트, 그리고 스프레드시트와 다른 서비스 간의 연동까지 다양한 업무를 자동화할 수 있습니다. 이러한 환경을 구축하면 워크플로우가 한층 간소화되고 수작업 부담도 크게 줄어듭니다. 지금 바로 API 연동을 실험하고 연습하며 새로운 가능성을 열어보세요.