시작하기

API 호출을 시작하려면 Google Play Console에서 직접 Google Play Developer API를 설정하고 관리합니다. 이 API는 Google Play 개발자 계정 소유자만 관리할 수 있습니다. 다음 지침에서는 아래의 내용에 관해 설명합니다.

  • 신규 또는 기존 Google Cloud 프로젝트 설정
  • OAuth 클라이언트 관리
  • 서비스 계정을 사용하여 Google Play Developer API에 액세스
  • 앱 분석을 위한 특수 API 액세스

계정과 프로젝트 연결

Google Play Developer API에 액세스하려면 먼저 Google Play 개발자 계정을 Google Cloud 프로젝트에 연결해야 합니다. 대부분의 경우 Google Play 개발자 계정 전용인 새 Google Cloud 프로젝트를 만드는 것이 좋지만 기존 프로젝트를 연결해도 됩니다. 각 Google Play 개발자 계정에는 Google Cloud 프로젝트 하나만 연결할 수 있습니다. 같은 Google Play 개발자 계정에 앱이 여러 개 있다면 모두 같은 Google Cloud 프로젝트를 공유해야 합니다.

새 프로젝트 만들기

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. 서비스 약관에 동의합니다.
  3. 새 프로젝트 만들기를 클릭합니다.

Google Cloud 프로젝트가 자동으로 생성되어 Google Play Console에 연결됩니다.

기존 프로젝트 사용

기존 Google Play Developer API 사용자인 경우 다음 단계에 따라 기존 API 프로젝트에 연결할 수 있습니다. 연결하려는 API 프로젝트가 목록에 없으면 Google Play Console 계정이 소유자로 지정되고 Google Play Developer API가 활성화되어 있는지 확인합니다.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. API 서비스 약관에 동의합니다.
  3. 연결하려는 프로젝트를 선택합니다.
  4. 기존 프로젝트 연결을 클릭합니다.

OAuth 및 서비스 계정 구성

OAuth 클라이언트나 서비스 계정을 사용하여 Google Play Developer API 액세스를 구성해야 합니다. 대부분의 경우 서비스 계정을 사용하여 API에 액세스하게 됩니다.

서비스 계정은 서버와 같은 보안 환경에서 사용해야 합니다. API 사용 권한이 없는 사람에게 서비스 계정의 사용자 인증 정보가 공개되는 일이 없도록 사용자 인증 정보를 안전하게 관리하세요.

OAuth 클라이언트 ID는 개별 사용자를 대신하여 API에 액세스해야 할 때 사용됩니다. 예를 들어 웹사이트에서 사용자를 대신하여 웹 클라이언트의 Google Play Developer API에 액세스해야 하면 클라이언트 ID를 사용하면 됩니다. 사용자는 서비스 계정이 아닌 Google 계정으로 인증됩니다. 이를 통해 서비스 계정의 사용자 인증 정보를 노출하지 않고 사용자를 대신하여 API를 호출할 수 있습니다.

  • 서비스 계정: 보안 소프트웨어 서비스가 API에 액세스합니다(가장 일반적).
  • OAuth 클라이언트: 사용자가 API에 액세스합니다.

서비스 계정 사용

Google Play Console에서 서비스 계정을 만들 수 있습니다.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. 서비스 계정에서 새 서비스 계정 만들기를 클릭합니다.
  3. 페이지의 안내에 따라 서비스 계정을 만듭니다.
  4. Google Play Console에서 서비스 계정을 만든 다음 완료를 클릭합니다. API 액세스 페이지가 자동으로 새로고침되고 서비스 계정이 표시됩니다.
  5. 액세스 권한 부여를 클릭하여 작업을 실행하는 데 필요한 권한을 서비스 계정에 제공합니다.

    Google Play 결제 API를 사용하려면 다음 권한을 부여해야 합니다.

    • 재무 데이터, 주문, 취소 설문조사 응답 보기
    • 주문 및 정기 결제 관리

이제 서비스 계정을 통해 Google Play Developer API에 액세스할 수 있습니다. 자세한 내용은 서버 대 서버 애플리케이션에서 OAuth 2.0 사용하기를 참고하세요.

OAuth 클라이언트 사용

사용자가 OAuth 클라이언트를 사용하여 본인의 사용자 인증 정보로 API를 통해 작업하도록 할 수 있습니다. 사용자의 작업은 Google Play Console의 사용자 및 권한 페이지에서 허용하는 작업으로 제한됩니다.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. OAuth 클라이언트에서 OAuth 클라이언트 만들기를 클릭합니다.
  3. 상품의 브랜드 정보를 설정하고 계속을 클릭합니다.
  4. 클라이언트 ID 만들기를 클릭합니다.

새 Oauth 클라이언트 상세 정보가 이 페이지의 목록에 표시됩니다.

특수 API

Google Play Developer API에는 앱에서 특정 유형의 분석 작업에 사용되는 특수 API가 몇 가지 포함되어 있습니다.

Reply to Reviews API
앱에 관한 사용자 의견을 보고 이 의견에 답할 수 있습니다.
Voided Purchases API
사용자가 무효화한 구매와 관련된 인앱 상품의 액세스 권한을 취소할 수 있습니다.

클라이언트 라이브러리

REST API에 프로그래밍 방식으로 액세스하는 데 사용할 수 있는 클라이언트 라이브러리가 있습니다. 클라이언트 라이브러리 및 코드 샘플에서 자세한 내용을 확인하세요.