Fix: Add OAuth consent screen setup guide

- OAuth 동의 화면 설정 단계 추가
- 테스트 사용자 추가 방법 명시
- 403 access_denied 오류 해결 방법 추가
- 트러블슈팅 섹션 강화
- '앱이 확인되지 않음' 경고 대처법 추가

Fixes #1 (403 access_denied error)
This commit is contained in:
2026-02-10 04:06:35 +09:00
parent c23da42ca7
commit 483c1ac6e7

View File

@@ -31,7 +31,28 @@ Gmail API를 활용하여 이메일을 자동으로 분류하고 답장하는 RP
2. "Gmail API" 검색 2. "Gmail API" 검색
3. "사용" 클릭 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 및 서비스" → "사용자 인증 정보" 1. "API 및 서비스" → "사용자 인증 정보"
2. "+사용자 인증 정보 만들기" → "OAuth 클라이언트 ID" 2. "+사용자 인증 정보 만들기" → "OAuth 클라이언트 ID"
3. 애플리케이션 유형: "데스크톱 앱" 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 파일이 없습니다" ### "credentials.json 파일이 없습니다"
1. Google Cloud Console에서 OAuth 클라이언트 ID 생성 1. Google Cloud Console에서 OAuth 클라이언트 ID 생성
2. credentials.json 다운로드 2. credentials.json 다운로드
@@ -275,6 +324,11 @@ python gmail_automation.py
- 일반 사용으로는 초과 불가능 - 일반 사용으로는 초과 불가능
- 문제 발생 시 Google Cloud Console에서 확인 - 문제 발생 시 Google Cloud Console에서 확인
### "앱이 확인되지 않음" 경고
- 정상적인 현상입니다 (테스트 모드)
- "고급" → "이동" 클릭하면 사용 가능
- 개인 사용이므로 문제없음
## 💡 추가 기능 아이디어 ## 💡 추가 기능 아이디어
- [ ] GUI 버전 (tkinter/PyQt) - [ ] GUI 버전 (tkinter/PyQt)