- この記事は、Google Playゲームサービスに関する記事を和訳したものです。
- 原文: Getting Started with the Google Play Games Services Publishing API
- 元記事のライセンスは CC-BYで、この和訳記事のライセンスは CC-BYです。
- 自己責任でご利用ください。
- 和訳した時期は 2019年7月ころです。
Google Playゲームサービス Publishing APIへの呼び出しをし始めるには、あなたは Google Play Consoleから直接 APIプロジェクトにリンクし、そのプロジェクトのために Google Playゲームサービス Publishing APIを有効化しなければなりません。 ひとたびあなたの APIプロジェクトがセットアップされたならば、それは、あなたが所有する他のゲームのプロジェクトを管理するために使用することができます。
Google Playゲームサービス Publishing APIは、あなたの Google Play Developer accountの所有者によってのみ設定することができます。 以下の手順は、方法を説明します:
- 新しいあるいは既存の APIプロジェクトをセットアップします
- OAuthクライアントを管理します
- Google Playゲームサービス Publishing APIにアクセスするために、サービスアカウントを使用します
あなたの APIプロジェクトをセットアップする
Google Playゲームサービス Publishing APIにアクセスする前に、あなたの Google Play Consoleを APIプロジェクトにリンクしなければなりません。 ほとんどの場合、現在の Google Play Developer Publishing APIのユーザは既存の APIプロジェクトにリンクすることができますが、新しい APIプロジェクトを作成することが奨励されます。 それぞれの APIプロジェクトは、単一の Google Play Consoleアカウントにのみリンクされることができることに注意してください。
新しい APIプロジェクトを作成する
- oogle Play Consoleの API Accessページに移動します。
- サービス利用規約に同意します。
- Create new projectをクリックします。 APIプロジェクトが自動的に生成され、あなたの Google Play Consoleにリンクされます。
- ゲームサービス Publishing APIオプションを ONにします。
今や、あなたの APIプロジェクトは、Google Playゲームサービス Publishing APIにアクセスするように構成されました。
既存の APIプロジェクトを使用する
もしあなたが既に Google Play Developer APIのユーザであるならば、あなたは次の手順で既存の APIプロジェクトをセットアップすることができます。 もし、あなたがセットアップしたい APIプロジェクトがリストされていなければ、あなたの Google Play Consoleアカウントが Ownerとして指定されていること、および、Google Play Developer APIが有効になっていることを確認します。
- Google Play Consoleの API Accessページに移動します。
- APIのサービス利用規約に同意します。
- あなたがセットアップしたいプロジェクトを選択します。
- Linkをクリックします。 あなたの Google Play Consoleは APIプロジェクトにリンクされます。
- ゲームサービス Publishing APIオプションを ONにします。
今や、あなたの APIプロジェクトは、Google Playゲームサービス Publishing APIにアクセスするように構成されました。
APIアクセスクライアントをセットアップする
OAuthクライアントを使用する
あなたは、ユーザに、OAuthクライアントを使用して、彼ら自身の資格情報の下で Google Playゲームサービス Publishing APIを介したアクションを実行できるようにすることができます。
ユーザのアクションは、Google Play Consoleの User Accounts & Rightsページを経由して許可されたものに限定されています。
- Google Play Consoleの API Accessページに移動します。
- OAuth Clientsの下にある Create OAuth Clientをクリックします。
- あなたの製品のブランド情報を構成し、Continueをクリックします。
- Create Client IDをクリックします。
あなたの新しい OAuthクライアントの詳細は、このページのリストに表示されます。
サービスアカウントを使用する
あなたの個人的なユーザ資格情報を提供することなく、ビルドサーバから Google Playゲームサービス Publishing APIにアクセスするための service accountを作成することもできます:
- Google Play Consoleの API Accessページに移動します。
- Service Accountsの下にある Create Service Accountをクリックします。
- あなたのサービスアカウントを作成するために、ページの指示に従います。
- ひとたび Google Developers Console上でサービスアカウントを作成したならば、Doneをクリックします。 API Accessページが自動的に更新され、あなたのサービスアカウントがリストされるでしょう。
- サービスアカウントにアクションを実行するための必要な権限を提供するために、Grant Accessをクリックします。
この時点で、あなたはサービスアカウントを介して Google Playゲームサービス Publishing APIにアクセスすることができるはずです。 詳細については Using OAuth 2.0 for Server to Server Applicationsを参照してください。
Google Playゲームサービス Publishing APIにアクセスする
あなたは HTTPを経由して直接 Google Playゲームサービス Publishing APIにアクセスすることができます。 詳細については、API referenceおよび sample appを参照してください。