구글 API 서비스 계정 만들기 때문에 헤맬 필요 없습니다. 이 글 하나면 서비스 계정 생성부터 credentials.json 발급까지 한 번에 끝낼 수 있습니다.
📂 Credentials.json 파일 다운로드 받기
이 단계에서는 구글 시트 API에 접근할 수 있도록,
서비스 계정 인증 파일(credentials.json)을 발급받습니다.
이 파일은 본인 구글 계정 기준으로 1회만 만들어두면 이후 계속 재사용할 수 있습니다.
✅ 준비물
- 구글 계정 (Gmail)
- 인터넷 브라우저 (Chrome 권장)
📑 전체 진행 목차
- 1) Google Cloud Console 접속
- 2) 사용자 인증 정보 메뉴로 이동
- 3) 사용자 인증 정보 만들기
- 4) 서비스 계정 생성
- 5) 생성된 서비스 계정 선택
- 6) JSON 키 생성 및 다운로드
- 자주 묻는 질문 (FAQ)
1) Google Cloud Console 접속
- 안내된 링크를 클릭해 Google Cloud Console로 이동합니다.
- 해당 페이지에서 프로젝트 선택/생성이 필요할 수 있습니다. (처음이라면 새 프로젝트 생성 후 진행)
2) 사용자 인증 정보 메뉴로 이동
- 좌측 상단의 ≡ (햄버거 메뉴) 버튼을 클릭합니다.
- [API 및 서비스]를 클릭합니다.
- 하위 메뉴에서 [사용자 인증 정보]를 클릭합니다.
3) 사용자 인증 정보 만들기
- 상단의 [사용자 인증 정보 만들기] 버튼을 클릭합니다.
- 목록에서 [서비스 계정]을 선택합니다.
4) 서비스 계정 생성
- 서비스 계정 이름 입력란에 본인 식별이 쉬운 이름을 입력합니다.예: my-tool-sa, dword-tool, adsense-farm-sa 등
- [만들고 계속하기]를 클릭합니다.
- 역할(Role)에서 소유자(Owner)를 선택합니다.
- [계속]을 클릭합니다.
- [완료]를 클릭합니다.
5) 생성된 서비스 계정 선택
- 방금 만들어진 서비스 계정을 목록에서 찾아 클릭합니다.
6) JSON 키 생성 및 다운로드
- 상단 탭에서 [키] 탭을 클릭합니다.
- [키 추가] 버튼을 클릭합니다.
- [새 키 만들기]를 클릭합니다.
- 형식 선택에서 JSON을 선택합니다.
- [만들기]를 클릭하면 파일이 자동 다운로드됩니다.
자주 묻는 질문 (FAQ)
Q1. credentials.json 파일은 정확히 어디에 사용하나요?
credentials.json은 구글 API에서 서비스 계정의 신원을 증명하는 인증 파일입니다.
이 파일을 사용하면 구글 시트, 구글 드라이브, 구글 캘린더, Blogger API 등에서
사람이 로그인하지 않아도 프로그램이 자동으로 접근할 수 있습니다.
주로 Python, Node.js, n8n, Make, 서버 자동화, 크론 작업 등에서 사용됩니다.
Q2. JSON 키 파일은 외부에 공유해도 되나요?
절대 안 됩니다. credentials.json은 비밀번호와 같은 역할을 하므로
외부에 노출되면 누군가 내 구글 리소스를 마음대로 접근할 수 있습니다.
깃허브, 블로그, 메신저 등에 업로드하지 말고,
서버나 로컬 PC의 .env 설정 또는 비공개 폴더에 보관하세요.
Q3. 서비스 계정에 Editor 권한을 꼭 줘야 하나요?
아닙니다. 최소 권한 원칙이 가장 안전합니다.
예를 들어 구글 드라이브만 사용할 경우,
프로젝트 전체 Editor 대신 Drive API + 특정 폴더 공유만으로도 충분합니다.
테스트 단계에서는 Editor 권한이 편하지만,
운영 환경에서는 필요한 API 권한만 부여하는 것을 권장합니다.
Q4. JSON 키를 분실했거나 유출된 것 같으면 어떻게 하나요?
즉시 해당 키를 삭제하고 새 키를 발급해야 합니다.
기존 키를 삭제해도 서비스 계정 자체는 유지되며,
새로운 credentials.json 파일을 다시 다운로드하면 됩니다.
키 회전(정기 교체)을 해주면 보안 측면에서 훨씬 안전합니다.
여기까지가 구글 플랫폼에서 서비스 계정을 생성하고 credentials.json 인증 파일을 발급받는 전체 과정입니다.
이 파일은 구글 시트, 구글 드라이브 등 다양한 구글 API를 외부 서비스나 프로그램과 연동할 때
본인 계정을 대신해 접근 권한을 증명하는 핵심 역할을 합니다.
처음 접하면 복잡해 보일 수 있지만, 실제로는
서비스 계정 생성 → 권한 설정 → JSON 키 발급이라는
정해진 흐름만 이해하면 이후에는 같은 방식으로 언제든 다시 만들 수 있습니다.
특히 자동화, 데이터 연동, API 기반 작업을 고려하고 있다면
이 과정은 한 번쯤 반드시 익혀두는 것이 도움이 됩니다.
다음 단계에서는 발급한 서비스 계정을 실제로 사용하기 전에 반드시 거쳐야 하는
OAuth 동의 화면 설정 과정을 다뤄보겠습니다.
구글 API를 사용하는 서비스나 프로그램은 이 동의 절차가 제대로 설정되어 있지 않으면
정상적으로 작동하지 않거나 인증 오류가 발생할 수 있습니다.
OAuth 동의 화면에서 어떤 항목을 선택해야 하는지,
외부 사용자 설정은 어떻게 해야 하는지,
그리고 초보자들이 가장 많이 막히는 설정 포인트를 중심으로
단계별로 정리해보겠습니다.