API 呼び出しを開始するには、まず Google Play デベロッパー アカウントへの API アクセスを設定する必要があります。 これには、Google Play Console と Google Cloud Console の両方の変更が含まれます。Google Play Developer Reporting API を使用するために必要な 4 つのステップは次のとおりです。
- デベロッパー アカウントを新規または既存の Google Cloud プロジェクトにリンクします。
- リンクした Google Cloud プロジェクトで Google Play Developer Reporting API を有効にします。
- リンクした Google Cloud プロジェクトで Google Play Developer Reporting API の API キーを承認します。
- 適切な Google Play Console の権限でサービス アカウントを設定し、Google Play Developer Reporting API にアクセスします。
ステップ 1 と 4 は、Google Play Console で Google Play デベロッパー アカウントの所有者である必要があります。すべての手順は、Google Cloud Console でリンクされた Google Cloud プロジェクトの所有者である必要があります。
アカウントとプロジェクトをリンクする
Google Play Developer Reporting API にアクセスするには、Google Play デベロッパー アカウントを Google Cloud プロジェクトにリンクする必要があります。ほとんどの場合、Google Play デベロッパー アカウント専用の新しい Google Cloud プロジェクトを作成することをおすすめしますが、既存のプロジェクトをリンクすることもできます。各 Google Play デベロッパー アカウントは 1 つの Google Cloud プロジェクトにのみリンクできることに注意してください。同じ Google Play デベロッパー アカウント内に複数のアプリがある場合、それらのアプリはすべて同じ Google Cloud プロジェクトを共有する必要があります。
新しいプロジェクトを作成する
- Google Play Console の [API アクセス] ページに移動します。
- [新しいプロジェクトを作成] をクリックします。
Google Cloud プロジェクトが自動的に作成され、Google Play デベロッパー アカウントにリンクされます。
既存のプロジェクトを使用する
すでに Google Cloud Console をご利用の場合は、以下の手順で既存の Google Cloud プロジェクトにリンクできます。
- Google Play Console の API アクセスページに移動します。
- リンクするプロジェクトを選択します。 プロジェクトがリストにない場合は、リンクする Google Cloud プロジェクトのユーザー アカウントがオーナーとして指定されていることを確認します。
- [既存のプロジェクトをリンクする] をクリックします。
API の有効化
リンクした Google Cloud プロジェクトを設定したら、そのプロジェクトで Google Play Developer Reporting API を有効にする必要があります。そのためには、リンクされた Google Cloud プロジェクトの所有者である必要があります。
- Google Play Console の [API アクセス] ページに移動します。
- [API] で、Google Play Developer Reporting API を探して [オンにする] をクリックします。
Google Cloud プロジェクトを直接更新し、変更はすぐに反映されます。
API キーの承認
API を使用するには、リンクした Google Cloud プロジェクトで、Google Play Developer Reporting API の使用が許可されている API キーが必要です。これは Google Cloud Console で設定します。
サービス アカウントの構成
サービス アカウントは、サーバーなどの安全な環境で使用する必要があります。サービス アカウントの認証情報は、API の使用を許可されていないユーザーに公開されないように、安全に管理する必要があります。
サービス アカウントの作成
Google Play Console からサービス アカウントを作成できます。
- Google Play Console の [API アクセス] ページに移動します。
- [サービス アカウント] で [新しいサービス アカウントを作成] をクリックします。
- 手順に沿ってサービス アカウントを作成します。Cloud プロジェクトが Google Play Console に表示されるように、アカウントの作成プロセス中に、そのプロジェクトへのアクセスをサービス アカウントに許可する必要があります。
- Google Play Console でサービス アカウントを作成したら、[完了] をクリックします。API アクセス ページの [サービス アカウント] セクションが自動的に更新され、サービス アカウントの一覧が表示されます。
- [アクセスを許可] をクリックして、操作を実行するために必要な権限をサービス アカウントに付与します。
権限の付与
[API アクセス] ページに、リンクされた Google Cloud プロジェクトに属するサービス アカウントのリストが表示されます。アプリの Google Play Console データへのアクセスを許可するには、アクセス権を付与する必要があります。
- Google Play Console の [API アクセス] ページに移動します。
- [サービス アカウント] で、アクセスを許可するサービス アカウントを見つけて、[アクセスを許可] をクリックします。[ユーザーを招待] ページが表示されます。
- 必要な情報を入力します。目的の API アクションの呼び出しに必要な最小限の権限のみをサービス アカウントに付与することをおすすめします。
- [ユーザーを招待] ボタンをクリックします。
これらの手順を完了すると、適切な API キーを使用してサービス アカウントを使用して Google Play Developer Reporting API にアクセスできるようになります。
Reference
特定のリソースタイプまたはメソッドについて調べるには、リファレンスをご覧ください。