Google 콘솔 설정

개요

Google Play로 앱을 출시하려면 Google Play Console과 Google Cloud Console에서 여러 값을 확인해 Hive 콘솔에 등록해야 합니다. 이 문서는 각 값을 확인하는 위치와 방법, 확인한 값을 등록할 Hive 콘솔 화면을 안내합니다. 콘솔 화면에서 값을 입력하고 저장하는 방법은 관련 콘솔 가이드에서 설명합니다.

스토어 App ID 등록

패키지 이름은 Google Play가 앱을 식별하는 값입니다. Hive Axyl은 이 값을 기준으로 Google Play와 연동해 로그인, 결제 등을 처리하므로, 로그인 연동과 결제 연동을 설정하기 전에 먼저 등록하세요.

Google Play Console에 접속해 대상 앱의 패키지 이름을 확인하세요.

확인한 패키지 이름은 Hive 콘솔 프로젝트 설정 > App ID에서 Google Play 스토어로 만든 App ID의 Store App ID에 등록합니다. 등록 방법은 Store App ID 등록을 참조하세요.

Google 로그인과 Google Play Games 로그인은 서로 다른 로그인 수단입니다. 앱에서 제공할 로그인 수단에 맞춰 Google Cloud Console의 OAuth 2.0 클라이언트를 준비하세요. Google Play Games 로그인을 사용하면 Google Play Console에서 Play 게임즈 서비스도 구성합니다.

두 로그인 수단 모두 웹 애플리케이션 유형 클라이언트가 필요합니다. Android에서 Google 로그인을 제공하거나 Google Play Games 로그인을 사용하면 앱 서명을 확인할 Android 유형 클라이언트도 함께 준비합니다.

Hive Axyl 서버는 웹 애플리케이션 유형 OAuth 2.0 클라이언트의 인증 정보로 Google 로그인 결과를 검증합니다. Android에서 Google 로그인을 제공하면 앱 서명을 확인할 Android 유형 클라이언트도 함께 만들어야 합니다.

Google Cloud Console에 접속한 후 OAuth 클라이언트를 만들 클라우드 프로젝트를 선택하고 API 및 서비스 > 사용자 인증 정보로 이동하세요.
OAuth 2.0 클라이언트 ID 목록에서 웹 애플리케이션 유형 클라이언트를 선택하세요. 클라이언트가 없으면 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 선택하고 애플리케이션 유형으로 웹 애플리케이션을 지정해 만드세요.
Android 외의 실행 환경에서도 Google 로그인을 제공하면 승인된 리디렉션 URI에 앱이 사용할 리다이렉트 URI를 추가하세요.
클라이언트 ID에 표시된 값을 복사하세요.
클라이언트 보안 비밀번호에 표시된 값을 복사하세요.
Android에서 Google 로그인을 제공하면 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 선택하고 애플리케이션 유형으로 Android를 지정해 클라이언트를 하나 더 만드세요. 이때 앱의 패키지 이름과 서명 키의 SHA-1 인증서 지문을 입력하세요. 디버그 빌드와 릴리스 빌드의 서명 키가 다르면 지문을 각각 등록하세요.

Google Play 서비스는 앱의 패키지 이름과 서명으로 Android 유형 클라이언트를 직접 확인합니다.

Google Play Games 로그인은 Google Cloud Console과 Google Play Console 양쪽에 설정이 필요합니다. Google Cloud Console에서는 웹 애플리케이션 유형 클라이언트와 앱 서명을 확인할 Android 유형 클라이언트를 준비하고, Google Play Console에서는 Play 게임즈 서비스에 두 클라이언트를 연결합니다.

Google Cloud Console에 접속한 후 API 및 서비스 > 사용자 인증 정보로 이동하세요.
OAuth 2.0 클라이언트 ID 목록에서 Android 유형 클라이언트를 확인하세요. 클라이언트가 없으면 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 선택하고 애플리케이션 유형으로 Android를 지정해 만드세요. 이때 앱의 패키지 이름과 서명 키의 SHA-1 인증서 지문을 입력하세요.
같은 목록에서 웹 애플리케이션 유형 클라이언트를 선택하세요. 클라이언트가 없으면 새 OAuth 클라이언트를 만들 때 애플리케이션 유형으로 웹 애플리케이션을 지정하세요.
이 클라이언트의 승인된 리디렉션 URI에 앱 서버 리다이렉트 URI 준비에서 정한 주소를 등록하세요. 코드에서 RedirectUri로 전달하는 값과 등록한 값은 같아야 합니다.
클라이언트 ID와 클라이언트 보안 비밀번호를 복사하세요.
Google Play Console에 접속한 후 Play 게임즈 서비스 > 설정 및 관리 > 설정으로 이동하세요.
처음 설정한다면 Play 게임즈 서비스 구성을 시작하고, 화면에 표시된 Games services 프로젝트 ID를 복사하세요. 이 값은 앱의 Android 리소스에 사용합니다.
OAuth 클라이언트를 만든 클라우드 프로젝트를 선택하세요. Play 게임즈 서비스와 OAuth 클라이언트가 같은 클라우드 프로젝트에 속해야 서로 연결됩니다.
Play 게임즈 서비스의 사용자 인증 정보에 앞에서 확인한 Android 유형 클라이언트를 등록하세요.
같은 사용자 인증 정보에 앞에서 복사한 웹 애플리케이션 유형 클라이언트를 연결하세요. 연결하지 않으면 서버 교환용 인가 코드 요청이 실패합니다.

3. Hive 콘솔 설정으로 이동

로그인 수단에 맞는 인증 정보를 등록하고 활성화하세요.

결제 연동

Google Play 결제는 사용자가 결제를 마친 뒤 Hive Axyl 서버가 Google Play의 서비스 계정 키로 영수증을 검증하는 방식으로 동작합니다. 검증에 사용할 인증 정보와 판매할 상품 정보를 Google 콘솔에서 확인해 Hive 콘솔에 등록해야 Google Play 결제가 동작합니다. 구독 상품을 판매하지 않으면 4단계는 건너뛰세요.

1. License Key 확인

License Key는 Google Play가 앱마다 발급하는 인앱 결제 라이선스 키입니다.

Google Play Console에 접속한 후 대상 앱을 선택하세요.
수익 창출 > 수익 창출 설정 > 라이선스로 이동하세요.
표시된 라이선스 키를 복사하세요.

2. 서비스 계정 키 발급

서비스 계정 키는 Hive Axyl 서버가 Google Play에 영수증 확인을 요청할 때 사용하는 자격 증명이며, JSON 파일로 발급받습니다.

Google Cloud Console에 접속한 후 Google Play Android Developer 프로젝트를 선택하세요. 프로젝트가 없으면 Google Play Console의 API 액세스 페이지에서 프로젝트를 먼저 만드세요.
IAM 및 관리자 > 서비스 계정으로 이동하세요.
사용할 서비스 계정을 선택한 후 키 탭으로 이동하세요.
키 추가를 선택하고 키 유형을 JSON으로 선택한 후 만들기를 선택해 JSON 파일을 내려받으세요.

JSON 파일은 이 화면에서 다시 내려받지 못합니다. 파일을 잃어버리면 키를 새로 발급받아 Hive 콘솔에 다시 등록해야 합니다.

3. 판매할 상품 등록과 상품 ID 확인

Hive Axyl은 Hive 콘솔에 등록한 상품 ID로 Google Play에 등록된 상품 정보를 조회합니다. 따라서 Google Play Console에 등록한 상품 ID와 Hive 콘솔에 등록할 상품 ID가 같아야 합니다.

Google Play Console에서 판매할 인앱 상품 또는 구독 상품을 등록하고 상품 ID를 확인하세요.

4. Google 콘솔에 구독 알림 설정

구독 상품을 판매하면 Google Play가 구독 상태 변경 알림을 Hive Axyl 서버로 보내도록 Google Cloud Console에 Pub/Sub 주제와 구독을 만들고, Google Play Console에서 실시간 개발자 알림을 켭니다.

Google Cloud Console에서 서비스 계정 키를 발급받은 프로젝트를 선택한 후 API 및 서비스 > 라이브러리에서 Cloud Pub/Sub API를 사용 설정하세요.
Pub/Sub > 주제로 이동해 알림을 받을 새 주제를 만드세요.
만든 주제를 선택한 후 권한 탭에서 google-play-developer-notifications@system.gserviceaccount.com 서비스 계정에 Pub/Sub 게시자 역할을 부여하세요. 이 권한이 없으면 Google Play가 주제에 알림을 게시하지 못합니다.
Pub/Sub > 구독으로 이동해 앞에서 만든 주제에 대한 새 구독을 만드세요. 이미 만들어 둔 구독이 있다면 해당 구독을 선택한 후 구독 수정으로 이동해도 됩니다.
전송 유형에서 푸시를 선택하고 푸시 엔드포인트에 https://api.hiveaxyl.com/payment/v1/webhook/subscription/google을 입력하세요.
Google Play Console에 접속한 후 대상 앱을 선택하고 수익 창출 > 수익 창출 설정으로 이동하세요.
실시간 개발자 알림에서 실시간 알림 사용 설정을 켜세요.
주제 이름에 projects/{project_id}/topics/{topic_name} 형식으로 앞에서 만든 주제 이름을 입력하세요.
테스트 메시지 보내기를 선택해 알림이 정상적으로 전달되는지 확인하세요.
변경사항 저장을 선택하세요.

5. Hive 콘솔에 등록

Google 콘솔에서 확인한 값은 아래 위치에 등록합니다. Hive Axyl 서버는 스토어 설정에 등록한 인증 정보로 영수증을 검증하고, 상품 등록에 등록한 상품 ID로 Google Play의 상품 정보를 조회합니다.

Google 콘솔에서 확인한 값	Hive 콘솔 등록 위치	등록 방법
License Key, 서비스 계정 키 JSON 파일	결제 > 스토어 설정의 Google Play 카드	Google Play 인증 정보
상품 ID	결제 > 상품 등록	상품 등록

서비스 계정 키 JSON 파일은 Google 마켓 계정에 등록합니다. 상품을 등록할 때 결제 플랫폼은 Google Play를 선택하세요. Google Play 상품의 실제 결제 가격은 Google Play Console에서 관리하므로, Hive 콘솔에 입력한 가격은 결제 금액에 영향을 주지 않습니다.

App ID마다 다른 인증 정보를 사용한다면 App ID별 인증 정보 설정에서 개별로 등록하세요.

구독 상품을 판매하면 구독 상태 변경 알림을 전달받을 앱 서버 URL도 결제 > 구독 서버 알림 URL에 등록합니다. 등록 방법은 구독 서버 알림 URL을 참조하세요. 알림을 받을 앱 서버가 아직 없으면 앱 서버에서 서버를 먼저 등록하세요.

푸시 알림 연동

Google Play 푸시 알림은 Firebase Cloud Messaging(FCM)을 사용해 발송합니다. Android 앱에서 푸시 알림을 사용하려면 Firebase 콘솔에서 FCM 연동 정보를 준비해야 합니다.

아래의 순서와 같이 Google FCM(Firebase Cloud Messaging) 인증 키를 준비합니다.

1. 프로젝트 ID 확인

Firebase 콘솔에서 푸시 알림을 사용할 프로젝트를 선택하세요. 선택한 프로젝트의 프로젝트 ID를 확인하세요.

Firebase 콘솔에 접속한 후 프로젝트를 선택하세요.
프로젝트 설정 > 일반으로 이동하세요.
프로젝트 ID에 표시된 값을 복사하세요.

2. 서비스 Key 파일 발급

Firebase 콘솔에서 Hive Axyl 푸시 알림 서버가 FCM에 접근할 때 사용할 서비스 Key 파일을 발급하세요.

프로젝트 설정 > 서비스 계정으로 이동하세요.
새 비공개 키 생성을 선택하세요.
안내 창에서 키를 생성하세요.
생성한 JSON 파일을 내려받으세요.

발급한 파일을 안전한 곳에 보관하세요. 파일을 잃어버리면 새 비공개 키를 생성하세요.

3. Hive 콘솔에 등록

FCM 푸시 알림 수단을 설정하려면 푸시 > 푸시 설정으로 이동하세요. 확인한 값을 Hive 콘솔에 등록합니다.

Firebase 콘솔에서 준비한 값	Hive 콘솔 등록 위치
프로젝트 ID	푸시 > 푸시 설정의 FCM 설정
서비스 Key 파일	푸시 > 푸시 설정의 FCM 설정

프로젝트 ID를 입력하세요.

내려받은 JSON 형식의 서비스 Key 파일을 업로드하고 저장을 선택하세요.