API 호출을 시작하기 전에 먼저 Google Play 개발자 계정에 대한 API 액세스를 설정해야 합니다. 여기에는 Google Play Console 및 Google Cloud 콘솔의 변경사항이 모두 포함됩니다. 다음 안내에서는 Google Play Developer API 사용을 시작하는 데 필요한 단계를 설명합니다.
- Google Cloud 프로젝트 만들기
- Google Cloud 프로젝트에 Google Play Developer API를 사용 설정합니다.
- Google Play Developer API에 액세스할 수 있는 관련 Google Play Console 권한을 가지는 서비스 계정을 설정합니다.
Google Cloud 프로젝트 만들기
이미 사용하기를 원하는 Google Cloud 프로젝트가 있다면 이 단계를 건너뛸 수 있습니다.
Google Cloud 콘솔에서 프로젝트를 만듭니다.
Google Cloud 프로젝트에 관해 자세히 알아보려면 프로젝트 만들기 및 관리를 참고하세요.
API 사용 설정
Google Cloud 프로젝트를 설정했다면 이 프로젝트에 대한 Google Play Developer API를 사용 설정해야 합니다.
Google Play Developer API를 사용 설정하려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 Google Play Developer API 페이지로 이동합니다.
- 사용 설정을 클릭합니다.
OAuth 및 서비스 계정 구성
OAuth 클라이언트나 서비스 계정을 사용하여 Google Play Developer API 액세스를 구성해야 합니다. 대부분의 경우 서비스 계정을 사용하여 API에 액세스하게 됩니다.
서비스 계정은 서버와 같은 보안 환경에서 사용해야 합니다. API 사용 권한이 없는 사람에게 서비스 계정의 사용자 인증 정보가 공개되는 일이 없도록 사용자 인증 정보를 안전하게 관리하세요.
OAuth 클라이언트 ID는 개별 사용자를 대신하여 API에 액세스해야 할 때 사용됩니다. 예를 들어 웹사이트에서 사용자를 대신하여 웹 클라이언트의 Google Play Developer API에 액세스해야 하면 클라이언트 ID를 사용하면 됩니다. 사용자는 서비스 계정이 아닌 Google 계정으로 인증됩니다. 이를 통해 서비스 계정의 사용자 인증 정보를 노출하지 않고 사용자를 대신하여 API를 호출할 수 있습니다.
- 서비스 계정: 보안 소프트웨어 서비스가 API에 액세스합니다(가장 일반적).
- OAuth 클라이언트: 사용자가 API에 액세스합니다.
서비스 계정 사용
Google Play Console에서 서비스 계정을 만들 수 있습니다.
- Google Cloud 콘솔에서 서비스 계정으로 이동합니다.
- 서비스 계정 만들기를 클릭하고 단계를 따릅니다.
- Google Play Console에서 사용자 및 권한 페이지로 이동합니다.
- 신규 사용자 초대를 클릭합니다.
이메일 주소 입력란에 서비스 계정에 사용할 이메일 주소를 입력하고 작업을 수행하기 위해 필수적인 권한을 부여합니다.
Google Play 결제 API를 사용하려면 다음 권한을 부여해야 합니다.
- 재무 데이터, 주문, 취소 설문조사 응답 보기
- 주문 및 정기 결제 관리
사용자 초대를 클릭합니다.
이제 서비스 계정을 통해 Google Play Developer API에 액세스할 수 있습니다. 자세한 내용은 서버 간 애플리케이션에서 OAuth 2.0 사용하기를 참고하세요.
OAuth 클라이언트 사용
사용자가 OAuth 클라이언트를 사용하여 본인의 사용자 인증 정보로 API를 통해 작업하도록 할 수 있습니다. 사용자의 작업은 Google Play Console의 사용자 및 권한 페이지에서 허용하는 작업으로 제한됩니다.
OAuth 클라이언트를 만들기 전에 제품의 브랜드 정보를 구성해야 합니다. 자세한 내용은 OAuth 동의 화면 설정을 참고하세요.
- Google Cloud 콘솔에서 OAuth 동의 화면 페이지로 이동합니다.
- 단계에 따라 OAuth 동의 화면을 만듭니다.
OAuth 클라이언트를 만들려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형을 선택하고 안내를 따릅니다.
추가 정보
다음 도움말 및 유용한 정보를 사용하여 Google Play에서 API 사용을 시작해 보세요.
개발자 ID 받기
일부 API의 경우 Google Play Console 개발자 ID를 제공해야 합니다. 이 번호는 Google Play 개발자 계정을 만들 때 할당된 긴 번호입니다. 개발자 ID는 API 액세스 페이지와 같이 Google Play Console에 있는 거의 모든 페이지의 URL에서 찾을 수 있습니다.
예를 들어 Google Play Console URL을 살펴보겠습니다.
https://play.google.com/console/developers/1234567890123456789/api-access
위 URL에서 개발자 ID는 1234567890123456789입니다.
참고: 앱이 Google Play 개발자 계정에서 다른 개발자 계정으로 이전되면 앱과 연결된 개발자 ID가 변경됩니다. 즉, 이전이 완료되면 앱의 API 호출에서 새 Google Play 개발자 계정의 개발자 ID를 사용해야 합니다.
특수 API
Google Play Developer API에는 앱에서 특정 유형의 분석 작업에 사용되는 특수 API가 몇 가지 포함되어 있습니다.
- Reply to Reviews API
- 앱에 관한 사용자 의견을 보고 이 의견에 답할 수 있습니다.
- Voided Purchases API
- 사용자가 무효화한 구매와 관련된 인앱 상품의 액세스 권한을 취소할 수 있습니다.
클라이언트 라이브러리
REST API에 프로그래매틱 방식으로 액세스하는 데 사용할 수 있는 클라이언트 라이브러리가 있습니다. 클라이언트 라이브러리 및 코드 샘플에서 자세한 내용을 확인하세요.