API を呼び出すには、Google Play デベロッパー アカウントへの API アクセスを設定する必要があります。これには、Google Play Console と Google Cloud コンソールの両方の変更が必要になります。下記の手順では、Google Play Developer API の使用を開始するために必要な以下のステップについて説明します。
- Google Cloud プロジェクトを作成する。
- リンクした Google Cloud プロジェクトで Google Play Developer API を有効にする。
- 適切な Google Play Console の権限でサービス アカウントを設定し、Google Play Developer API にアクセスします。
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 の使用を許可されていない人に知られることのないように、安全に管理する必要があります。
各ユーザーの代わりに API にアクセスする必要がある場合は、OAuth クライアント ID を使用してください。たとえば、ウェブサイトがユーザーの代わりにウェブ クライアントから 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 は、Google Play Console のほぼすべてのページ（[API アクセス] ページなど）の 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 にアクセスするために使用できるクライアント ライブラリを提供しています。詳細については、クライアント ライブラリとコードサンプルをご覧ください。