Google Play Games Services Publishing API を呼び出すには、Google Play Console から API プロジェクトに直接リンクし、そのプロジェクトで Google Play Games Services Publishing API を有効にする必要があります。セットアップした API プロジェクトは、自分の他のゲーム プロジェクトの管理にも使用できるようになります。
Google Play Games Services Publishing API を設定できるのは Google Play デベロッパー アカウントの所有者だけです。その方法について、下記の手順で説明します。
- 新規または既存の API プロジェクトをセットアップする
- OAuth クライアントを管理する
- サービス アカウントを使って、Google Play Games Services Publishing API にアクセスする
API プロジェクトをセットアップする
Google Play Games Services 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 プロジェクトは Google Play Games Services 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 プロジェクトは Google Play Games Services Publishing API にアクセスするように設定されました。
API アクセス クライアントをセットアップする
OAuth クライアントを使用する
ユーザーが OAuth クライアントを使用して自分の認証情報により Google Play Games Services Publishing API 経由で操作を行えるようにすることができます。
ユーザーの操作は、Google Play Console の [ユーザー アカウントと権限] ページで許可されているものに限られます。
- Google Play Console の [API アクセス] ページに移動します。
- [OAuth クライアント] で [OAuth クライアントを作成] をクリックします。
- サービスの情報を設定して [続行] をクリックします。
- [クライアント ID を作成] をクリックします。
新しい OAuth クライアントの詳細がこのページの一覧に表示されます。
サービス アカウントを使用する
サービス アカウントを作成して、個人ユーザーとしての認証情報を提示せずに、ビルドサーバーから Google Play Games Services Publishing API にアクセスすることもできます。
- Google Play Console の [API アクセス] ページに移動します。
- [サービス アカウント] で [サービス アカウントを作成] をクリックします。
- ページに表示される手順のとおり、サービス アカウントを作成します。
- Google Developers Console でサービス アカウントを作成したら、[完了] をクリックします。[API アクセス] ページが自動的に更新され、サービス アカウントが一覧に表示されます。
- [アクセスを許可] をクリックすると、操作を実行するのに必要な権限がサービス アカウントに付与されます。
これでサービス アカウントを使って、Google Play Games Services Publishing API にアクセスできるようになります。詳細については、サーバー間アプリケーションでの OAuth 2.0 の使用についての記事をご覧ください。
Google Play Games Services Publishing API にアクセスする
Google Play Games Services Publishing API には HTTP を介して直接アクセスできます。詳細については API リファレンスとサンプルアプリをご覧ください。