HELP / SETUP
Google OAuth 직접 설정 가이드
YouTube·Gmail 연결을 위해 본인의 Google Cloud OAuth 클라이언트를 발급받는 방법입니다. 한 번만 설정하면 평생 사용 가능합니다. 약 5~10분 소요.
영상으로 따라하시려면 위 재생 버튼을 눌러주세요. 글로 보시려면 아래 단계를 차례대로 진행해 주세요.영상 전용 페이지 →
왜 본인 Google 계정으로 설정하나요?
YouTube 댓글 답글, Gmail 자동 답장은 Google이 가장 민감한 권한으로 분류한 기능입니다. 사용자 데이터를 다른 회사가 대신 보관하는 방식 대신, 본인 Google 계정에서 직접 권한을 발급해 핑크루에 위임하는 방식이 가장 안전합니다. 권한 범위·회수 모두 본인이 통제합니다.
- 1
Google Cloud 프로젝트 만들기
Google Cloud Console에 접속해서 핑크루에서 사용할 Gmail 계정으로 로그인합니다.
상단의 프로젝트 선택 드롭다운 → 새 프로젝트 만들기.
- 프로젝트 이름: 예) “Pingcrew Personal”
- 조직: “조직 없음” 그대로
- 만들기
무료 등급으로 충분히 사용 가능합니다. 결제 카드 등록 불필요.
- 2
필요한 API 활성화
좌측 메뉴 → “API 및 서비스” → “라이브러리”에서 다음 두 가지 API를 검색하고 각각 사용 설정 클릭.
- YouTube Data API v3
- Gmail API
- 3
OAuth 동의 화면 설정
좌측 메뉴 → “API 및 서비스” → “OAuth 동의 화면”.
- 사용자 유형: 외부 선택 → 만들기
- 앱 이름: “Pingcrew” (본인이 알아볼 수 있는 이름이면 자유)
- 사용자 지원 이메일: 본인 Gmail
- 개발자 연락처 정보: 본인 Gmail
- 저장 후 계속
범위 단계는 건너뛰어도 됩니다 (저장 후 계속).
테스트 사용자: 본인 Gmail 추가 (필수). YouTube·Gmail 연결할 계정 모두 추가.
저장 후 게시 상태는 테스트 그대로 두면 됩니다. (프로덕션으로 바꾸지 마세요)
- 4
OAuth 클라이언트 ID 발급
좌측 메뉴 → “API 및 서비스” → “사용자 인증 정보”.
- 상단 “+ 사용자 인증 정보 만들기” → “OAuth 클라이언트 ID”
- 애플리케이션 유형: 웹 애플리케이션
- 이름: “Pingcrew Client”
- 승인된 리디렉션 URI — 아래 두 개를 모두 추가하세요.
- https://pingcrew.kr/api/platforms/youtube/callback
- https://pingcrew.kr/api/email/gmail/callback
- 만들기
팝업으로 Client ID와 Client Secret이 표시됩니다. 둘 다 복사해두세요. (보안상 화면 닫으면 Secret은 다시 다운로드해야 함)
- 5
핑크루에 입력
내 Google OAuth 설정 페이지로 이동.
- Client ID 붙여넣기
- Client Secret 붙여넣기
- 저장
이후 평소처럼 YouTube·Gmail 연결 버튼을 누르면 본인 OAuth로 진행됩니다.
- 6
“확인되지 않은 앱” 경고가 떠도 정상
본인이 만든 앱이라 Google이 검증한 적이 없습니다. 본인 계정이라 안전합니다.
- 경고 화면에서 “고급” 클릭
- “(앱이름)(으)로 이동(안전하지 않음)” 클릭
- 이후 권한 동의 화면이 정상 표시됨
테스트 사용자로 등록된 계정만 통과합니다. 다른 사람 계정으로 시도하면 막히니 3단계에서 본인 Gmail을 꼭 추가해주세요.
