시작하기

API 호출을 시작하기 전에 먼저 Google Play 개발자 계정에 대한 API 액세스를 설정해야 합니다. 여기에는 Google Play Console 및 Google Cloud Console의 변경사항이 모두 포함됩니다. 다음 안내에서는 Google Play Developer API 사용을 시작하는 데 필요한 4단계를 설명합니다.

  1. 개발자 계정을 신규 또는 기존 Google Cloud 프로젝트에 연결합니다.
  2. 연결된 Google Cloud 프로젝트에 Google Play Developer API를 사용 설정합니다.
  3. 연결된 Google Cloud 프로젝트에서 Google Play Developer API에 대한 API 키를 승인합니다.
  4. Google Play Developer API에 액세스할 수 있는 관련 Google Play Console 권한을 가지는 서비스 계정을 설정합니다.

계정 및 프로젝트 연결

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. 새 프로젝트 만들기를 클릭합니다.

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

기존 프로젝트 사용

이미 Google Cloud Console 사용자인 경우 다음 단계에 따라 기존 Google Cloud 프로젝트에 연결할 수 있습니다.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. 연결하려는 프로젝트를 선택합니다. 프로젝트가 목록에 없으면 연결하려는 Google Cloud 프로젝트에서 사용자 계정이 소유자로 지정되었는지 확인합니다.
  3. 기존 프로젝트 연결을 클릭합니다.

API 사용 설정

연결된 Google Cloud 프로젝트를 설정했다면 이 프로젝트에 대한 Google Play Developer API를 사용 설정해야 합니다. 이렇게 하려면 Google Cloud 프로젝트의 소유자여야 합니다.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. API에서 Google Play Developer API를 찾아 사용을 클릭합니다.

그러면 Google Cloud 프로젝트가 직접 업데이트되며 변경사항이 즉시 적용됩니다.

API 키 승인

API를 사용하려면 연결된 Google Cloud 프로젝트에 Google Play Developer API를 사용하도록 승인된 API 키가 필요합니다. Google Play Console에서 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에서 서비스 계정을 만들 수 있습니다.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. 서비스 계정에서 새 서비스 계정 만들기를 클릭합니다.
  3. 안내에 따라 서비스 계정을 만드세요.

    계정을 만드는 과정에서 Google Cloud 프로젝트 액세스 권한을 서비스 계정에 부여해야 계정이 Google Play Console에 표시됩니다.

  4. Google Play Console에서 서비스 계정을 만든 다음 완료를 클릭합니다. API 액세스 페이지의 서비스 계정 섹션이 자동으로 새로고침되고 서비스 계정이 표시됩니다.

  5. 액세스 권한 부여를 클릭하여 작업을 실행하는 데 필요한 권한을 서비스 계정에 제공합니다.

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

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

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

OAuth 클라이언트 사용

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

OAuth 클라이언트를 만들기 전에 제품의 브랜드 정보를 구성해야 합니다. 자세한 내용은 OAuth 동의 화면 설정을 참고하세요.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. OAuth 클라이언트에서 OAuth 동의 화면 구성을 클릭합니다.
  3. 제품의 브랜드 정보를 구성합니다.
  4. 완료한 후 OAuth 동의 새로고침을 클릭합니다. 섹션이 업데이트되고 브랜드 정보에 관한 메시지가 더 이상 표시되지 않습니다.

Google Play Console을 사용하여 OAuth 클라이언트를 만들려면 다음 안내를 따르세요.

  1. Google Play Console에서 API 액세스 페이지로 이동합니다.
  2. OAuth 클라이언트에서 새 OAuth 클라이언트 만들기를 클릭합니다.
  3. 페이지의 안내를 따라 OAuth 클라이언트를 만듭니다.
  4. Google Play Console에서 OAuth 클라이언트를 만든 후 완료를 클릭합니다. API 액세스 페이지의 OAuth 클라이언트 섹션이 자동으로 새로고침되고 OAuth 클라이언트가 표시됩니다.

    새 OAuth 클라이언트가 페이지에 바로 표시되지 않을 때도 있습니다. 이 경우 OAuth 클라이언트 새로고침을 클릭합니다.

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

추가 정보

다음 도움말 및 유용한 정보를 사용하여 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
사용자가 무효화한 구매와 관련된 인앱 상품의 액세스 권한을 취소할 수 있습니다.

클라이언트 라이브러리

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