Gmail·Google Calendar OAuth 인증 & Slack 버튼 인터랙션 설정 가이드
코딩쉐프2025. 9. 22. 21:21
728x90
이번 글은 지난 포스트에서 다룬 Google Sheets API 서비스 계정 설정과 Slack Webhook 설정에 이어, Gmail·Google Calendar API를 활용할 때 필요한 OAuth 인증 과정과, Slack에서 버튼 클릭까지 반영하려는 경우 필요한 Interactivity 설정을 정리했습니다.
1. 왜 추가 설정이 필요한가?
Google Sheets는 서비스 계정(JSON 키)만으로 접근이 가능합니다.
하지만 Gmail과 Google Calendar는 사용자 데이터(메일·일정) 를 다루기 때문에 서비스 계정이 아닌 사용자 OAuth 인증이 필요합니다.
또한 Slack은 기본 Incoming Webhook으로 알림 전송까지만 가능하지만, 버튼 클릭 이벤트 처리까지 하려면 Interactivity 설정이 추가로 필요합니다.
2. Gmail·Google Calendar OAuth 인증 가이드
Google Cloud Console 준비
새/기존 프로젝트에서 Gmail API, Calendar API 사용 설정
OAuth 동의 화면 구성 (앱 이름, 권한 범위 설정)
인증 정보 → OAuth 클라이언트 ID 생성 (데스크톱 앱 권장)
credentials.json 다운로드
OAuth 토큰 생성 (로컬 실행) 아래 예제 스크립트를 실행해 token.json을 생성합니다.
from google_auth_oauthlib.flow import InstalledAppFlow
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
import os
SCOPES = [
"https://www.googleapis.com/auth/gmail.readonly",
"https://www.googleapis.com/auth/calendar",
]
def main():
creds = None
if os.path.exists("token.json"):
creds = Credentials.from_authorized_user_file("token.json", SCOPES)
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file("credentials.json", SCOPES)
creds = flow.run_local_server(port=0)
with open("token.json", "w") as token:
token.write(creds.to_json())
print("OAuth 완료: token.json 생성됨")
if __name__ == "__main__":
main()
실행 후 브라우저에서 구글 계정을 선택하고 권한을 승인하면 같은 폴더에 token.json이 생성됩니다.
Gmail/Calendar를 통합 스코프로 인증하면 하나의 token.json으로 모두 접근 가능
스코프를 바꾸면 기존 token.json을 삭제하고 다시 실행해야 새로 동의 화면이 뜹니다
추가 설명 & 주의사항
OAuth 클라이언트 JSON 파일명
Google Cloud Console에서 다운로드하면 보통 client_secret_xxxxx.apps.googleusercontent.com.json 같은 긴 이름으로 내려받음
코드에서 credentials.json 으로 되어 있으니, 파일명을 맞추거나 실제 파일명을 코드에 넣어야 함
테스트 사용자 추가
앱이 아직 “테스트 모드”라면, OAuth 동의 화면 → 테스트 사용자에 본인 Gmail 계정을 반드시 추가해야 인증 가능
추가하지 않으면 403 access_denied 오류 발생
token.json 파일 관리
Gmail/Calendar 통합 스코프로 발급받으면 하나의 token.json으로 두 API 모두 접근 가능
스코프(SCOPES)를 바꾸면 기존 token.json은 삭제하고 다시 실행해야 새로 동의 화면이 뜸
에러 해결 팁
FileNotFoundError: credentials.json → 파일 이름 불일치. 다운로드 받은 JSON 파일명을 확인
403 access_denied → 테스트 사용자에 본인 계정 추가 필요
insufficientPermissions → 스코프가 바뀌었는데 기존 토큰 재사용 → token.json 삭제 후 재발급
