가이드 목록으로
구글 워크스페이스 연동

Google OAuth 클라이언트 만들기 (Gmail·Drive 등)

Gmail·Google Drive·Calendar·Docs·Sheets·YouTube 등 구글이 제공하는 여러 서비스에 접근하려면 Google Cloud Console에서 OAuth 2.0 인증 절차를 거쳐야 합니다. 과정이 여러 단계라 조금 복잡하지만, 순서대로 따라하면 어렵지 않게 완료할 수 있습니다.

  1. console.cloud.google.com에 로그인하고 새 프로젝트를 만듭니다.
  2. 좌측 메뉴 API 및 서비스 → 라이브러리에서 사용하려는 구글 API(예: Gmail API, Google Drive API, YouTube Data API v3)를 검색해 활성화합니다.
  3. API 및 서비스 → OAuth 동의 화면에서 User Type을 "외부"로 선택하고 앱 이름 등 기본 정보를 입력합니다. 게시 상태는 "테스트중"으로 두고 테스트 사용자에 본인 구글 계정을 추가합니다 — 이 단계를 빼먹으면 본인 계정으로도 로그인이 거부됩니다.
  4. 데이터 액세스(범위) 단계에서, 사용하려는 서비스에 맞는 범위(scope)를 추가합니다. 예: Gmail은 gmail.readonly·gmail.send 등, Google Drive는 drive·drive.readonly 등을 필요한 만큼만 추가합니다.
  5. 사용자 인증 정보 → OAuth 클라이언트 ID 만들기에서 애플리케이션 유형을 웹 애플리케이션으로 선택하고, 승인된 리디렉션 URI에 AI Master의 해당 프로그램 설정 페이지에 안내된 콜백 주소를 정확히 추가합니다.
  6. 생성이 완료되면 클라이언트 ID와 클라이언트 보안 비밀(Client Secret)이 발급됩니다. 이 두 값을 메모장 등에 복사해두세요.
  7. 복사한 값을 AI Master의 해당 프로그램 설정 페이지에 등록합니다.

💡 유튜브 관련 프로그램, AI 음악 자동생성기 등 이미 다른 AI Master 프로그램에서 Client ID/Secret을 등록해두셨다면, 그 값을 그대로 재사용하고 리디렉션 URI만 새 프로그램 주소로 추가 등록하면 됩니다.