Google Cloud OAuth 동의 설정부터 앱 게시까지 완벽 가이드

OAuth 동의 단계에서 계속 막히셨나요?
이 튜토리얼은 초보자도 그대로 따라 하면
OAuth 동의 화면 설정부터 앱 게시까지
중간에 멈추지 않고 한 번에 완료할 수 있도록 정리했어요.
실제 테스트까지 끝내면 OAuth 동의 과정에서 자주 발생하는
인증 에러·검토 보류 이슈가 자연스럽게 해소됩니다.
한 번 완주해 두면 이후 프로젝트에서도
OAuth 동의를 기준 문서처럼 빠르게 재사용할 수 있어요.

🧭 초보자용 OAuth 동의 설정 & 앱 게시 튜토리얼

이 문서는 Google Cloud Console에서 OAuth 동의를 올바르게 구성하고, 필요한 범위·테스트 사용자·브랜딩 정보를 채운 뒤 앱 게시까지 완료하는 과정을 단계별로 안내해요. 각 단계에서 OAuth 동의에 영향을 주는 핵심 체크 포인트를 함께 확인합니다.

✅ 준비물

• 구글 계정(Gmail)
• Google Cloud Console 접근 권한
• 사용할 프로젝트 1개(이 프로젝트에서 OAuth 동의를 진행해요)
• 개발자 연락처 이메일(알림 수신용)
• 개인정보처리방침/서비스 약관 URL(민감/제한 범위 및 게시 시 필요할 수 있어요)

📑 전체 진행 목차

• 1) 프로젝트 선택과 진입
• 2) OAuth 동의 화면 열기
• 3) 앱 정보 입력
• 4) 사용자 유형(외부) 선택
• 5) 범위(Scopes) 설정
• 6) 테스트 사용자 추가
• 7) 브랜딩·정책 URL 확인
• 8) 저장, 검토, 앱 게시
• 9) 클라이언트 ID 연동 및 테스트
• 자주 묻는 질문(FAQ)

구글 플랫폼(Cloud Console) 바로가기

1) 프로젝트 선택과 진입

1. Google Cloud Console로 이동해요.
2. 상단 프로젝트 선택기에서 사용할 프로젝트를 지정해요. 이 프로젝트에서 OAuth 동의를 설정하게 됩니다.

2) OAuth 동의 화면 열기

1. 좌측 메뉴에서 API 및 서비스 → 사용자 인증 정보를 클릭해요.
2. 상단 탭의 OAuth 동의 화면을 선택하면 OAuth 동의 설정 페이지로 이동해요.

3) 앱 정보 입력

1. 앱 이름, 사용자 지원 이메일, 개발자 연락처를 채워요. 이 정보는 OAuth 동의 팝업에 표시돼요.
2. 브랜드 로고는 선택 사항이에요. 우선 필수값만 채우고 진행해도 OAuth 동의 테스트에는 문제가 없어요.

4) 사용자 유형(외부) 선택

1. 사용자 유형은 외부로 선택해요. 외부를 선택해도 초기에는 테스트 모드로 OAuth 동의를 진행할 수 있어요.
2. 테스트 모드에서는 등록한 이메일만 OAuth 동의를 통과할 수 있어요.
   
   
   

5) 범위(Scopes) 설정

1. 필요한 API에 맞춰 범위를 추가해요. 불필요한 민감/제한 범위를 넣으면 OAuth 동의 검토 부담이 커져요.
2. 최소 권한 원칙을 지키면 OAuth 동의 심사도 간결해지고 오류도 줄어요.

6) 테스트 사용자 추가

1. 테스트에 사용할 구글 계정을 이메일로 추가해요. 이 단계가 누락되면 OAuth 동의 팝업에서 접근 거부가 나올 수 있어요.
2. 필요 시 여러 계정을 추가해 OAuth 동의 흐름을 다양한 환경에서 확인해요.

7) 브랜딩·정책 URL 확인

1. 앱 아이콘, 도메인, 지원/개발자 이메일을 점검해요. OAuth 동의 신뢰도와 게시 심사에 도움이 돼요.
2. 민감/제한 범위를 사용한다면 개인정보처리방침과 서비스 약관 URL을 준비해 OAuth 동의 정보에 넣어두면 좋아요.

8) 저장, 검토, 앱 게시

1. 모든 입력을 저장한 뒤 검토를 눌러요. 문제가 없으면 게시 단계로 이동해요.
2. 민감/제한 범위가 포함되면 추가 자료 제출이 필요할 수 있어요. 이때 OAuth 동의 상태 메시지를 확인해요.
3. 요건이 충족되면 앱을 게시로 전환해 OAuth 동의를 일반 사용자에게도 적용할 수 있어요.
4. 앱 게시가 완료 되면 테스트로 돌아가기 라는 버튼으로 바뀌어요.

9) 클라이언트 ID 연동 및 테스트

1. 사용자 인증 정보 → OAuth 클라이언트 ID 항목을 확인해요.
2. 리디렉션 URI(웹) 또는 애플리케이션 유형(데스크톱)이 올바른지 점검하고, 실제 로그인 플로우에서 OAuth 동의 팝업이 정상 표시되는지 테스트해요.

🔎 체크리스트 & 보안 팁

• 최소 권한 원칙: 꼭 필요한 범위만 추가해 OAuth 동의 검토를 간소화해요.
• 테스트 사용자 누락 주의: 등록하지 않으면 OAuth 동의 테스트가 차단돼요.
• 정책 URL 준비: 게시 전환과 OAuth 동의 신뢰성에 긍정적이에요.

구글 플랫폼(Cloud Console) 바로가기

자주 묻는 질문(FAQ)

좋아요, 이제 핵심은 모두 끝났어요! 이 문서대로 설정하면 OAuth 동의 흐름과 게시가 매끄럽게 이어져요. 다음은 실제 서비스 연동에서 발생할 수 있는 오류 코드별 대응과, 범위 확장 시 OAuth 동의 재검토를 빠르게 통과하는 팁을 정리해 드릴게요. 한 번 세팅해 두면 이후 프로젝트에서도 OAuth 동의를 빠르게 재사용할 수 있어요 🚀

👉 구글 API 서비스 계정 만들기
credentials.json 발급까지 5단계 정리