2026년 기준으로 서버나 스크립트 환경에서 구글 시트를 가장 안정적으로 제어하는 방법은 서비스 계정을 활용하는 것입니다. 일반적인 로그인 방식은 일정 시간이 지나면 토큰이 만료되어 재인증이 필요하지만 서비스 계정은 로봇 계정 개념이라 한 번 설정해두면 끊김 없이 데이터를 처리할 수 있거든요. 특히 자동화 프로그램을 운영하려는 분들에게는 선택이 아닌 필수 과정이라고 할 수 있습니다.
Google Sheets API 왜 서비스 계정을 써야 할까
구글 시트를 프로그래밍으로 제어할 때 가장 먼저 고민하는 것이 인증 방식입니다. 보통 개인 계정으로 연동하는 방식을 떠올리기 쉽지만 서버에서 돌아가는 프로그램은 사람이 직접 로그인 버튼을 누를 수 없다는 한계가 있어요. 서비스 계정은 구글이 제공하는 별도의 가상 계정으로 비밀번호 대신 JSON 형태의 키 파일을 사용하여 인증을 수행합니다.
사용자 승인 과정이 생략되기 때문에 웹 앱이나 데이터 수집용 스크립트를 돌릴 때 중간에 멈추는 일이 발생하지 않더라고요. 보안 측면에서도 특정 시트에만 권한을 부여할 수 있어 개인 계정 전체의 접근 권한을 넘겨주는 것보다 훨씬 안전하다는 장점이 있습니다.
구글 클라우드 프로젝트 생성하는 법
본격적인 설정을 위해 구글 클라우드 콘솔에 접속해야 합니다. (https://console.cloud.google.com)
화면 상단에 있는 프로젝트 선택 드라이브를 클릭하고 새 프로젝트를 만들어주세요. 이름은 본인이 나중에 확인했을 때 어떤 용도인지 바로 알 수 있도록 설정하는 것이 좋습니다.
- 프로젝트 이름 입력 예시: 블로그 자동화 프로젝트
- 생성 버튼 클릭 후 대시보드로 이동
- 상단 알림에서 프로젝트 생성이 완료되었는지 확인
프로젝트 생성 (새 프로젝트)
생성이 완료되면 해당 프로젝트가 선택된 상태인지 반드시 확인해야 합니다. 엉뚱한 프로젝트에서 API를 활성화하면 나중에 인증 오류가 발생해서 고생할 수 있거든요.
Google Sheets API 활성화 및 설정하기
프로젝트가 준비되었다면 이제 해당 프로젝트에서 구글 시트의 기능을 빌려 쓸 수 있도록 허가해줘야 합니다. 검색창에 단어를 입력하면 관련 항목이 나오는데 여기서 우리가 필요한 API를 찾아 사용 설정 버튼을 눌러주면 됩니다.
- 검색창에 Google Sheets API 입력 후 선택
- 사용 설정 버튼 클릭
- 파일 목록 조회가 필요한 경우 Google Drive API도 동일하게 활성화
기능을 활성화하지 않으면 데이터에 접근할 수 없으니 잊지 말고 체크해야 해요.
서비스 계정 생성 및 권한 부여 방법
이제 실제로 시트와 대화할 로봇 계정을 만들 차례입니다. 사용자 인증 정보 메뉴로 이동하여 상단의 ‘사용자 인증 정보 만들기’ 버튼을 누르고 서비스 계정을 선택하세요. 이름은 업무 성격에 맞게 지정하면 되고 이메일 형식의 아이디가 자동으로 생성되는 것을 볼 수 있습니다.
- 서비스 계정 이름 입력
- 역할 선택 단계에서 편집자 권한 부여
- 완료 버튼을 눌러 목록에 계정이 생성되었는지 확인
여기서 설정한 역할은 이 계정이 구글 클라우드 내에서 가지는 전반적인 권한입니다. 하지만 실제 개별 시트 파일에 대한 권한은 나중에 별도로 설정해야 하니 일단 편집자로 지정해두는 것이 작업하기 편하더라고요.
JSON 키 다운로드와 보안 관리 주의사항
계정 생성이 끝났다면 이제 내 프로그램이 이 계정임을 증명할 수 있는 신분증이 필요합니다. 생성된 서비스 계정의 상세 페이지로 들어가서 키 탭을 클릭하세요. 새 키 만들기를 선택하고 형식을 JSON으로 지정하면 파일이 자동으로 컴퓨터에 저장됩니다.
- 키 추가 메뉴에서 새 키 만들기 클릭
- JSON 형식 선택 후 생성
- 다운로드된 파일은 프로젝트 폴더의 안전한 곳으로 이동
이 파일은 한 번만 발급받을 수 있고 분실하면 다시 만들어야 합니다. 무엇보다 이 파일 자체가 비밀번호 역할을 하기 때문에 깃허브 같은 공용 공간에 실수로 올리지 않도록 주의해야 했어요. 환경 변수로 관리하거나 별도의 보안 폴더에 저장하는 습관이 중요합니다.
시트 공유 설정을 빠뜨리면 안 되는 이유
가장 많은 분들이 실수하고 질문하는 단계가 바로 여기입니다. API 설정과 키 다운로드까지 마쳤는데 막상 코드를 돌리면 접근 권한이 없다는 에러가 뜨곤 하죠. 그 이유는 대상이 되는 구글 시트 파일 자체가 서비스 계정의 존재를 모르기 때문입니다.
- 다운로드한 JSON 파일을 열어 이메일 주소 복사 (혹은 좀전에 생성된 이메일 주소를 화면에서 확인)
- 접근하려는 구글 시트 우측 상단의 공유 버튼 클릭
- 복사한 이메일을 붙여넣고 편집자 권한으로 공유
우리가 지인에게 시트를 공유하듯이 서비스 계정 이메일에게도 똑같이 문을 열어줘야 합니다. 이 과정을 거쳐야만 비로소 프로그램이 시트 내부의 데이터를 읽고 쓸 수 있는 상태가 됩니다.
도전인생 ‘블로그 자동화 솔루션’에서 연동하기
모든 설정이 끝났으니 이제 실제로 잘 작동하는지 확인해 볼 시간입니다.
도전인생 ‘블로그 자동화 솔루션’에서 이제 위에서 다운로드한 JSON 파일을 설정하면 됩니다.
그러면 이제 환상적인 블로그 자동화를 맛볼 수 있게 됩니다.
Google Sheets API 설정을 마무리하며
지금까지 2026년 기준 구글 시트 API를 서비스 계정으로 연동하는 전 과정을 살펴보았습니다. 처음에는 과정이 복잡해 보일 수 있지만 한 번만 제대로 구축해두면 수동 업무에서 벗어나 완벽한 자동화 시스템을 갖출 수 있습니다. 알려드린 6단계 과정을 차근차근 따라가면서 보안에 유의하며 설정을 진행해 보세요.
이제 여러분의 멋진 글을 세상에 선보일 준비가 모두 끝났습니다.
이어서 보면 좋은 글
#GoogleSheetsAPI #구글시트연동 #서비스계정 #파이썬자동화 #구글클라우드콘솔 #JSON키보안 #API설정방법 #데이터자동화 #구글API가이드 #코딩꿀팁