diff --git a/README.md b/README.md index 755f6a9..d734cbc 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,28 @@ Gmail API를 활용하여 이메일을 자동으로 분류하고 답장하는 RP 2. "Gmail API" 검색 3. "사용" 클릭 -#### Step 3: OAuth 2.0 클라이언트 ID 생성 +#### Step 3: OAuth 동의 화면 설정 ⭐ 중요! +1. "API 및 서비스" → "OAuth 동의 화면" +2. User Type: **"외부 (External)"** 선택 → "만들기" +3. **앱 정보 입력:** + - 앱 이름: `Gmail Automation RPA` + - 사용자 지원 이메일: 본인 이메일 + - 개발자 연락처 이메일: 본인 이메일 + - "저장 후 계속" 클릭 +4. **범위 추가:** + - "범위 추가 또는 삭제" 클릭 + - 다음 범위 검색 및 체크: + - `https://www.googleapis.com/auth/gmail.modify` + - `https://www.googleapis.com/auth/gmail.send` + - `https://www.googleapis.com/auth/gmail.labels` + - "업데이트" → "저장 후 계속" +5. **테스트 사용자 추가:** + - "+ADD USERS" 클릭 + - **본인 Gmail 주소 입력** (예: bgg8988@gmail.com) + - "추가" → "저장 후 계속" +6. "대시보드로 돌아가기" + +#### Step 4: OAuth 2.0 클라이언트 ID 생성 1. "API 및 서비스" → "사용자 인증 정보" 2. "+사용자 인증 정보 만들기" → "OAuth 클라이언트 ID" 3. 애플리케이션 유형: "데스크톱 앱" @@ -258,6 +279,34 @@ gmail-automation-rpa/ ## 🐛 트러블슈팅 +### 오류: 403 access_denied (가장 흔한 오류) + +**증상:** +``` +오류 403: access_denied +``` + +**원인:** +- OAuth 동의 화면에서 테스트 사용자로 등록되지 않음 + +**해결:** +1. Google Cloud Console → "OAuth 동의 화면" +2. "테스트 사용자" 섹션에서 "+ADD USERS" +3. **본인 Gmail 주소 입력** (예: bgg8988@gmail.com) +4. "추가" 클릭 +5. 기존 token.pickle 삭제: + ```bash + rm token.pickle + ``` +6. 프로그램 재실행: + ```bash + python gmail_automation.py + ``` +7. 브라우저에서 "앱이 확인되지 않음" 경고가 나오면: + - "고급" 클릭 + - "Gmail Automation RPA(으)로 이동" 클릭 + - 권한 승인 + ### "credentials.json 파일이 없습니다" 1. Google Cloud Console에서 OAuth 클라이언트 ID 생성 2. credentials.json 다운로드 @@ -275,6 +324,11 @@ python gmail_automation.py - 일반 사용으로는 초과 불가능 - 문제 발생 시 Google Cloud Console에서 확인 +### "앱이 확인되지 않음" 경고 +- 정상적인 현상입니다 (테스트 모드) +- "고급" → "이동" 클릭하면 사용 가능 +- 개인 사용이므로 문제없음 + ## 💡 추가 기능 아이디어 - [ ] GUI 버전 (tkinter/PyQt)