Publishing API の呼び出しを開始するには、Google Play Console から直接 API プロジェクトにリンクし、そのプロジェクトで Publishing API を有効にする必要があります。セットアップした API プロジェクトは、ご自分の他のゲーム プロジェクトの管理にも使用できます。
Publishing API を設定できるのは、Google Play デベロッパー アカウントの所有者だけです。以下の手順では、次のことを行う方法について説明しています。
- 新規または既存の API プロジェクトを設定する
- OAuth クライアントを管理する
- サービス アカウントを使用して Publishing API にアクセスする
API プロジェクトを設定する
Publishing API にアクセスするには、Google Play Console を API プロジェクトにリンクする必要があります。通常は新しい API プロジェクトを作成するようおすすめしますが、現在 Google Play Developer Publishing API をご利用であれば、既存の API プロジェクトにリンクすることができます。なお、各 API プロジェクトは Google Play Console の 1 つのアカウントにのみリンク可能であることにご注意ください。
新しい API プロジェクトを作成する
- Google Play Console の [API アクセス] ページに移動します。
- 利用規約に同意します。
- [新しいプロジェクトを作成] をクリックします。API プロジェクトが自動的に生成され、Google Play Console にリンクされます。
- [Games Services Publishing API] を [オン] にします。
これで、API プロジェクトが Publishing API にアクセスできるように設定されました。
既存の API プロジェクトを使用する
すでに Google Play Developer API をご利用の場合は、以下の手順で既存の API プロジェクトをセットアップできます。セットアップしようとする API プロジェクトが一覧にない場合、Google Play Console アカウントがその所有者として指定されていることと、Google Play Developer API が有効になっていることを確認します。
- Google Play Console の [API アクセス] ページに移動します。
- API 利用規約に同意します。
- セットアップするプロジェクトを選択します。
- [リンク] をクリックします。これで、Google Play Console がその API プロジェクトにリンクされます。
- [Games Services Publishing API] を [オン] にします。
これで、API プロジェクトが Publishing API にアクセスできるように設定されました。
API アクセス クライアントを設定する
Publishing API には、OAuth クライアントまたはサービス アカウントを使用してアクセスします。
OAuth クライアントを使用する
ユーザーが OAuth クライアントを使用して、API を通じて自身の認証情報で操作を実行できるようにします。
ユーザーが実行できる操作は、Google Play Console の [ユーザー アカウントと権限] ページで許可されているものに限られます。
- Google Play Console の [API アクセス] ページに移動します。
- [OAuth クライアント] で [OAuth クライアントを作成] をクリックします。
- サービスの情報を設定して [続行] をクリックします。
- [クライアント ID を作成] をクリックします。
新しい OAuth クライアントの詳細がページ上にリスト表示されます。
サービス アカウントを使用する
サービス アカウントを作成して、個人のユーザー認証情報を提供せずにビルドサーバーから Publishing API にアクセスすることもできます。
- Google Play Console の [API アクセス] ページに移動します。
- [サービス アカウント] で [サービス アカウントを作成] をクリックします。
- ページに表示される手順のとおり、サービス アカウントを作成します。
- Google Developers Console でサービス アカウントを作成したら、[完了] をクリックします。[API アクセス] ページが自動的に更新され、サービス アカウントの一覧が表示されます。
- [アクセスを許可] をクリックして、操作を実行するために必要な権限をサービス アカウントに付与します。
詳細については、サーバー間アプリケーションでの OAuth 2.0 の使用をご覧ください。
Google Play Games Services Publishing API にアクセスする
Publishing API には HTTP 経由で直接アクセスできます。詳細については、Publishing API リファレンスとサンプルアプリをご覧ください。