このドキュメントでは、Google Play Console を使用して Android ゲーム用に Google Play ゲームサービスを設定する方法について説明します。Google Play Console では、ゲームサービスを管理し、ゲームを承認および認証するためのメタデータを一元的に管理できます。
Google Play Console にゲームを追加する一般的な手順は次のとおりです。
- ゲームのゲーム プロジェクトを作成し、ゲームの名前や説明などの詳細を指定します。
- ゲームを認可および認証するために必要な認証情報を作成して Google Play ゲームサービスにリンクします。
上記の手順については、以降のセクションで詳しく説明します。
ステップ 1: Google Play Console にログインする
ログインするには、Google Play Console に移動します。これまで Google Play Console に登録していない場合は、登録を求めるメッセージが表示されます。
手順 2: Google Play Console にゲームを追加する
ゲームを追加する手順は次のとおりです。
- まだ作成していない場合は、Google Play Console でゲームを作成します。詳しくは、こちらをご覧ください。
- [成長] > [Play ゲームサービス] > [設定と管理] > [設定] に移動します。
ゲームで Google API（Firebase など）をすでに使用しているかどうかを指定します。正しい選択肢を選ぶことはとても重要です。
- これからゼロから作成するゲームの場合、または以前に Google API を設定したことがない場合は、[いいえ、ゲームで Google API を使用しません] を選択します。ゲームの名前を入力し、[作成] をクリックします。
- すでに 1 つ以上の Google API を設定しているゲームの場合は、[はい、ゲームで Google API をすでに使用しています] を選択します。Google Cloud Console で、デベロッパーとして登録されているプロジェクトのリストが表示されます。リストからプロジェクトを選択し、[使用する] をクリックします。
- 既存の Play ゲームサービス プロジェクトを使用する場合は、[既存の Play ゲームサービス プロジェクトを使用する] を選択します。アカウントの既存の Play ゲームサービス プロジェクトのリストが表示されます。リストから正しいゲーム プロジェクトを選択し、[使用する] をクリックします。これは一般的な選択ではありませんが、パッケージ名を変更するために Google Play Console で新しいゲームを作成する場合、またはパッケージ名が異なるゲームの無料版と有料版がある場合は、このように選択することをおすすめします。
Play ゲームサービスのゲーム プロジェクトが作成され、対応するエントリが Google Cloud Console に作成されます。
[プロパティ] で [プロパティを編集] を選択し、ゲームの説明、カテゴリ、画像および映像を追加できます。
- テストに必要なのは表示名のみです。他のフィールドは、ゲームを公開する前に入力する必要があります。
- ゲームの表示名と説明は、ゲームの Play ストアの掲載情報で設定した内容と一致する必要があります。
- 画像および映像の作成ガイドラインについては、デベロッパー向け Google Play ガイドと Google Play メイン画像のガイドラインをご覧ください。
手順 3. OAuth 2.0 クライアント ID を生成する
ゲームが認証され、認可を受けて Google Play ゲームサービスを呼び出すには、OAuth 2.0 クライアント ID が必要です。Play ゲームサービスの認証情報（クライアント ID とゲームの関連付け）を設定するには、Google Cloud Platform を使用してクライアント ID を作成します。次に、Google Play Console を使用して認証情報を追加し、クライアント ID をゲームにリンクします。
詳細な手順については、次の手順をご覧ください。
a. OAuth 同意画面を構成する
OAuth 同意画面をまだ設定していない場合は、[認証情報] セクションに、設定を求めるメッセージが表示されます。
[設定] をクリックします。ダイアログが開き、詳細な手順と Google Cloud Platform へのディープリンクが表示されます。
OAuth 同意画面の設定が完了したら、[完了] をクリックします。Google Play Console は自動的に更新され、設定が正常に完了すると認証情報を作成できます。
b. 認証情報を作成する
ゲームが Google Play ゲームサービスと通信できるようにするには、承認済みの OAuth2 クライアント ID で認証情報を作成する必要があります。
[認証情報] セクションで、[認証情報を追加] をクリックします。
ウィザードで、Android 認証情報（ゲーム APK がユーザーを認証して PGS API を使用する場合）を作成するか、ゲームサーバーの認証情報（ゲームサーバーで PGS API を使用する場合）を作成するかを選択します。必要な認証情報の種類に応じた手順に沿って操作します。
Android
認証情報の詳細を設定する
[名前] フィールドの名前がゲームの名前と一致していることを確認します。著作権侵害対策を有効にするかどうかを選択します。
認可を設定する
次に、このゲーム プロジェクトに使用する OAuth クライアント ID を選択します。すでに OAuth2 クライアント ID を保有している場合は、その ID を選択できます。ただし、通常は新規に作成します。[OAuth クライアントを作成] をクリックします。ダイアログが開き、ディープリンクと Google Cloud Platform で OAuth クライアント ID を作成するための手順が表示されます。
- アプリケーションの種類として [Android] を選択します。
- [名前] フィールドにゲームの名前を入力します。
- [パッケージ名] フィールドに Android アプリのパッケージ名を入力します。
ターミナルを開いて、Keytool ユーティリティを実行し、リリース証明書とデバッグ用証明書の SHA1 フィンガープリントを取得します。
リリース用証明書のフィンガープリントを取得するには、次のコマンドを実行します。
keytool -list -keystore <path-to-production-keystore> -vデバッグ用証明書のフィンガープリントを取得するには、次のコマンドを実行します。
keytool -list -keystore <path-to-debug-keystore> -vキーストアのパスワードの入力を求めるプロンプトが表示されます。デバッグ キーストアのデフォルト パスワードは
androidです。Keytool はフィンガープリントをターミナルに出力します。[署名証明書フィンガープリント（SHA1）] フィールドに SHA1 フィンガープリントを貼り付けます。
[作成] をクリックします。
Android での OAuth 2.0 の詳細については、OAuth2 サービスに対する認証をご覧ください。
ダイアログで [完了] をクリックすると、使用可能なクライアント ID が更新されます。作成した認証情報をプルダウン メニューから選択し、[変更を保存] をクリックします。これにより認証情報が下書きとして作成され、ゲーム内で Play ゲームサービスに対する認証を行うことができます。
リリース証明書のフィンガープリントとデバッグ証明書のフィンガープリントをそれぞれ使用する 2 つの認証情報を作成できます。両方に同じパッケージ名を使用してください。これにより、Google Play ゲームサービスは、いずれかの証明書で署名されリンクされた APK からの呼び出しを認識できます。Android の証明書の署名について詳しくは、アプリに署名するをご覧ください。
ゲームサーバー
認証情報の詳細を設定する
[名前] フィールドの名前がゲームの名前と一致していることを確認します。
認可を設定する
次に、このゲーム プロジェクトに使用する OAuth クライアント ID を選択します。すでに OAuth2 クライアント ID を保有している場合は、その ID を選択できます。ただし、通常は新規に作成します。[OAuth クライアントを作成] をクリックします。ダイアログが開き、ディープリンクと Google Cloud Platform で OAuth クライアント ID を作成するための手順が表示されます。
- アプリケーションの種類として [ウェブ アプリケーション] を選択します。
- [名前] フィールドにゲームの名前を入力します。
- [作成] をクリックします。
Android での OAuth 2.0 の詳細については、OAuth2 サービスに対する認証をご覧ください。
ダイアログで [完了] をクリックすると、使用可能なクライアント ID が更新されます。作成した認証情報をプルダウン メニューから選択し、[変更を保存] をクリックします。これにより認証情報が下書きとして作成され、ゲームサーバーから Play ゲームサービスに対する認証を行うことができます。ゲームサーバーでの Play ゲームサービスの使用について詳しくは、Google Play ゲームサービスへのサーバー側アクセスの有効化をご覧ください。
セットアップに関する一般的な問題を回避する
設定に関する一般的な誤りを回避するため、Google Play ゲームサービスを使用するようにゲームを設定する際は、以下の推奨事項に従ってください。
- 1. Google Play Console でゲームを設定する
- Google Cloud Console でアプリに OAuth 2.0 クライアント ID を作成しても、Google Play ゲームサービスはゲームの実績やリーダーボードとクライアント ID との関連付けを認識しません。この関連付けを作成するには、認証情報を作成するの説明に沿って、Oauth 2.0 クライアント ID を使用して認証情報を作成する必要があります。
- 2. Android で正しいアプリケーション ID を使用する
- アプリケーション ID は、Android マニフェストで参照する必要がある必須の文字列リソースです。アプリケーション ID の文字列は、Google Play Console によって指定されたクライアント ID の先頭の数字（通常は 12 桁以上）のみで構成されます。アプリケーション ID は [構成] ページの上部に表示され、ゲーム名の下にプロジェクト ID として表示されます。
- 3.正しい証明書を使用して APK に署名する
- Google Play Console で Android アプリをゲームにリンクする場合は、アプリの公開に使用したパッケージ名とまったく同じフィンガープリント証明書を使用する必要があります。一致しない場合、Google Play ゲームサービスの呼び出しは失敗します。2 つのクライアント ID（リリース証明書フィンガープリントを使用した ID とデバッグ証明書フィンガープリントを使用した ID）を作成し、両方に対して同じパッケージ名を使用する必要があります。Google Play Console で署名証明書を指定する方法について詳しくは、アプリに署名するをご覧ください。
- 4. Android 向けの開発では、Play Games SDK をスタンドアロン JAR ではなくライブラリ プロジェクトとして組み込む
- Google Play 開発者サービス SDK が Android プロジェクトでライブラリ プロジェクトとして参照されていることを確認してください。参照されていない場合は、アプリが Google Play 開発者サービス リソースを検出できない場合に、エラーが発生する可能性があります。Google Play 開発者サービスを使用するように Android プロジェクトを設定する方法については、Google Play 開発者サービスの設定をご覧ください。
- 5. 開発中にテスター アカウントでログインする
- Google Play Console でゲーム設定の変更を公開していない場合は、許可リストに登録されたテスター アカウントでログインしていないと、テスト中にエラーが発生する可能性があります。テスト用の Google Play Console のパブリッシャー アカウントを常に有効にする必要があります。テスター アカウントの管理方法については、テスト用のアカウントの有効化をご覧ください。
- 6. Google Cloud Platform で同意画面を公開する
- Google Play Console でアプリを公開する前に、Google Cloud Platform で同意画面を公開してください。このステップを実施しないと、一般ユーザーは Play ゲームサービスの機能を使用できません。
- 7. リリース時には、ゲームを公開する前に Play ゲームサービスの設定を公開する
- デベロッパーは、アプリに対応する Google Play ゲームサービスの設定を公開せずに、アプリを誤って公開する場合があります。これにより、テスター以外のアカウントでログインしているプレーヤーに対してエラーが発生する可能性があります。これは、アプリで正しいゲーム設定を参照できないためです。ゲームをリリースする場合は、まず Google Play Console の [ゲームを公開する] オプションを使用してゲームの設定を公開してください。変更を公開する方法については、ゲームの変更の公開をご覧ください。
その他のヒントについては、以下を参照してください。
- Android トラブルシューティング ガイド - Android ゲームの開発中にトラブルシューティングを行う方法を説明するデベロッパー向けドキュメントです。
次のステップ
次に進む前に、テスト用のアカウントの有効化の説明に沿って、テスト アカウントをゲームに追加する必要があります。承認済みのテスト アカウントを持つユーザーは、公開前の Play ゲームサービス ゲーム プロジェクトにアクセスし、設定済みの Google Play ゲームサービスが正しく機能していることをテストできます。
上記の初期設定タスクが完了したら、リーダーボードや実績など、ゲーム機能の構成に進むことができます。詳しくは、機能を有効にするをご覧ください。