Game > Gamebase > ストアコンソールガイド > Googleコンソールガイド

[告知] 本文書はGoogle Playにリリースされたアプリの情報を[Gamebase IAPコンソールに登録および連動させる方法について扱います。 Google Playにアプリをリリースするためのより詳細なコンソール設定関連事項については、Googleが提供するGoogle Play Consoleガイドを参照してください。

Google Cloudプロジェクトのリンク

  • Google Playに登録されたアプリに関する情報を連動させるにはGoogle PlayにリンクするGoogle Cloudプロジェクトが必要です。
  • Google Play Consoleの設定 > APIアクセスページに移動
    • 新規Google Cloudプロジェクトを作成するか、既存プロジェクトにリンクしてGoogle PlayとGoogle Cloudプロジェクトをリンクします。
    • すでにリンクされているGoogle Cloudプロジェクトがある場合はリンクされたGoogle Cloudプロジェクトの状態が表示されます。
    • Google Cloud Consoleメインページで事前にプロジェクトを作成してから既存プロジェクトにリンクすることもできます。

Google Cloudプロジェクトのリンク

  • Google PlayとGoogle Cloudの間のプロジェクト接続が正常に完了したら、Google Play Consoleの設定 > APIアクセスページにリンクされているGoogle CloudプロジェクトとAPIリストが表示されます。
  • 以下のガイドに沿って設定を完了した後、画面のようにリンクされたプロジェクトの状態が表示されない場合は、Google Cloudとの接続部分を確認してください。

Google Cloudプロジェクト接続

  • 新規プロジェクト作成後、連動認証設定を行うにはOAuth同意画面設定などが必要です。

Google Cloudプロジェクト接続

2つの連動認証方式を提供

NHN Cloud IAPアプリ設定

  • Google連携を行うには、GoogleのAndroid開発者APIにアクセスするための認証が必要です。
  • NHN Cloud IAPは、2つの認証モデルを提供し、それぞれ認証のために異なる特化情報が必要です。
  • モデル別特化情報のほか、共通で必要な情報もGoogle連携および決済確認のために必要なため、共通入力情報もあわせて確認する必要があります。
    • Store App ID:共通入力情報ガイドPackage Name参照
    • Google In App Purchase License Key:共通入力情報ガイドInAppPurchase License Public Key参照
    • マーケット連動検証省略:共通入力情報ガイドマーケット検証省略を参照
  • モデル特化/共通必要情報はGoogleが提供する以下のガイドラインに従ってください。 Google Cloud Platform Console, Google Play Console, Google Developer Consoleなどから入手できます。
  • Google Playアプリの決済情報を確認するためのGoogle Android Publisher APIはOAuth2必須認証対象APIです。

最高管理者(Supervisor)認証モデル

  • 登録するアプリをGoogleコンソールで管理するGoogleアカウントの認証を代行するモデルであり、NHN Cloud IAPがデフォルト値として提供してきた認証モデルです。
  • Google Consoleでは、1つのGoogleアカウントに複数のアプリを登録管理することができ、同じアカウントに登録されたアプリのNHN Cloud IAP設定情報はすべて同じです。
  • 次の案内に従って合計3つの情報を確認してNHN Cloud IAPのアプリ情報として入力する必要があります。この情報は該当GoogleアカウントのOAuth認証に使用されます。

  • NHN Cloud IAP Google最高管理者認証モデル特化入力情報

    • Google API Client ID:最高管理者認証モデルガイドのステップ4を参照
    • Google API Client Secret:最高管理者認証モデルガイドのステップ4を参照
    • Refresh Token For Google Oauth:最高管理者認証モデルガイドのステップ6を参照 最高管理者モデル設定
  • Google Cloud Console APIおよびサービスダッシュボードに移動

    • Google Play管理アカウントと連動するプロジェクトを選択
    • ユーザー認証情報メニューに移動
    • ユーザー認証情報を作成 > OAuthクライアントIDを選択

最高管理者モデル設定

  1. 新規OAuth Client基本情報の入力
    • アプリケーションタイプ:Webアプリケーションの指定
    • 名前:管理者がNHN Cloud IAP用であることを区別することができる適切な名称を指定
    • 承認されたjavascript原本:無視
    • 承認されたリダイレクトURI:追加後にhttps://developers.google.com/oauthplaygroundを入力

最高管理者モデル設定

  1. 新規OAuth Clientが作成されると、作成されたOAuth Clientの2つの情報についての案内ポップアップが表示されます。
    • クライアントID:NHN Cloud IAPアプリ情報設定画面のGoogle API Client IDの値を入力します。
    • クライアントセキュリティパスワード:NHN Cloud IAPアプリ情報設定画面のGoogle API Client Secretの値を入力します。
    • 上記の2つの情報はOAuth Client情報画面で再確認することができ、Googleが提供するOAuth Client情報JSONダウンロードファイルでも確認できます。

最高管理者モデル設定

  1. Google OAuth 2 Playgroundページに移動
    • 画面右上の歯車ボタンを押すと表示されるOAuth 2.0 Configurationポップアップ設定でUse your own OAuth credentialsチェックボックスをチェックします。
    • OAuth 2.0 Configurationポップアップ設定のClient ID、Client Secretにステップ4で取得した情報を入力します。
    • 左側のAPI権限範囲選択画面でGoogle Play Android Developer APIを選択します。
      • 左側の選択画面下の範囲入力部分にhttps://www.googleapis.com/auth/androidpublisherを入力しても構いません。
    • すべての設定値の入力と選択が完了したら左下のAuthorize APIボタンをクリックします。

最高管理者モデル設定

  1. Authorize APIボタンをクリックするとGoogle OAuth 2 PlaygroundページがStep 2に変わり、追加情報が表示されます。
    • Refresh Token:NHN Cloud IAPアプリ情報設定画面のRefresh Token For Google Oauthの値を入力します。

最高管理者モデル設定

サービスアカウント認証モデル

  • 最高管理者アカウントが委任した権限を持つGoogle内サービスアカウントの認証を代行するモデルであり、 2022年4月NHN Cloud IAPに新規追加された認証サポートモデルです。
  • 権限の範囲を委任されるサービスアカウントの作成および管理は最高管理者(Googleの実際の管理アカウント)がGoogleコンソールで行う必要があります。
  • サービスアカウントは最高管理者によって最高管理者に準ずる範囲の権限を受任することもでき、最高管理者が権限を持つ特定アプリだけに限定された範囲の権限を受任することもできます。
    • 委任権限範囲の設定戦略は、お客様の意図した特性に合わせて設定してください。
  • 最高管理者認証モデルが持つ権限の範囲に負担を感じる場合は、Googleコンソール内でサービスアカウント作成後にこの認証モデルを使用してください。 (Googleガイド)

  • NHN Cloud IAPサービスアカウント認証モデル特化入力情報

    • サービスアカウント連動情報:サービスアカウント認証モデルガイドのステップ5を参照 サービスアカウントモデル設定
  • Google Cloud Console APIおよびサービスページに移動

    • Google Play管理アカウントと連携するプロジェクトを選択
    • ユーザー認証情報メニューに移動
    • ユーザー認証情報を作成 > サービスアカウントを選択

サービスアカウントモデル設定

  1. 新規サービスアカウントの基本情報の入力
    • 管理しやすい形の基本情報を入力した後、作成して続行をクリックします。
    • サービスアカウントへのアクセス権限付与で役割を所有者と選択します。
    • 追加選択事項で作成するサービスアカウントの管理者メールを入力すると、その管理者にサービスアカウント設定の権限が付与されます。
      • Google Cloud Console内に存在しない管理者メールアドレスの場合は、入力したメールアドレスに管理者招待メールが送信されます。

サービスアカウントモデル設定

  1. サービスアカウントへの権限委任
    • Google Play Console > APIアクセスメニューに移動
    • Google Cloud Consoleで作成したサービスアカウントが画面下部のサービスアカウントリストに表示されます。作成したサービスアカウント右側の権限付与リンクをクリックします。
    • 権限の範囲は最高管理者アカウントが持つアプリ全体またはアプリ個別単位で複数指定することができ、範囲内で権限の種類を指定できます。
    • 範囲は顧客の意図に合わせて設定しますが、権限の種類のうちアプリ情報表示(読み取り専用)財務データ表示注文および購読管理の権限は必ず委任設定する必要があります。
    • 委任設定された権限は反映されるまで数日かかる場合があります。委任権限が反映されるまで最長7日程度かかった事例がありますのでご参考ください。

サービスアカウントモデル設定

  1. APIおよびサービスページの新しく作成されたサービスアカウントリストのうち、作成したサービスアカウントの詳細情報画面に移動
    • キータブに移動して、キー追加 > 新しいキーを作成
    • 新規ポップアップでJSON形式を選択して作成をクリック
    • キーの作成が完了すると、自動的にJSON形式のファイルをGoogleからダウンロードします。
    • そのファイルをWindowsのメモ帳などの純粋なテキストエディタで開き、すべての内容をコピーした後、NHN Cloud IAPアプリ情報設定画面のサービスアカウント連動情報に入力する必要があります。
    • ダウンロードしたファイルは最初のダウンロード後に、再ダウンロードすることはできませんので、大切に保管して入力してください。
    • ステップ4で言及したように、Google内部でまだ権限が反映されていない場合は権限なし登録エラーが発生することがありますので、このような場合は時間をおいて再試行してください。

サービスアカウントモデル設定

共通入力情報

Package Name

  • Google Play Consoleから登録したアプリをビルド時に指定したpackageNameがあります。この値はGoogle内でアプリの固有指定子として活用されます。
  • この値をNHN Cloud IAPアプリ設定のStore App IDに入力します。

InAppPurchase License Public Key

  • Google Play Console > 該当アプリダッシュボード > 収入創出メニューに移動
  • 画面下部にBase64エンコードされたライセンス公開鍵が表記されます。この値をNHN Cloud IAPアプリ設定のGoogle In App Purchase License Keyに入力します。

IAPライセンスキー

マーケット検証の省略

  • NHN Cloud IAPが提供するGoogle決済の検証は大きく2つのステップに分けられます。2つのステップのうちステップ2を省略するかどうかを設定します。
  • 省略は推奨仕様ではなく、まれに発生するGoogleサーバー障害状況に対応する一時的な決済承認状態を維持できます。 (デフォルト値はNO)
    • 省略しても、流入する決済検証リクエストが無条件正常決済として処理されるわけではありません。
    • 購読決済の検証は省略オプションが適用される範囲ではありません。

Google検証ステップ

ステップ 説明
ステップ1 検証がリクエストされた決済情報が改ざんされかたどうかを確認
ステップ2 検証がリクエストされた決済情報のGoogleサーバー側の最新ヘルスチェックおよび再検証

Googleシステム内のリアルタイム購読情報イベント配信設定

  • Googleが提供する購読購入のリアルタイム状態配信イベントをNHN Cloud IAPサーバーが受け取って処理するように設定できます。
  • Google Cloud Platformに決済プロフィールを登録し(クレジットカード必要)、使用状態に変更する必要があります。
  • この配信イベント設定をGoogle内で行わない場合、購読決済の更新情報がユーザーのアプリクライアント実行アクションに基づいて反映されるため、購読決済を使用する場合は設定することを推奨します。
  • 過去には購読リアルタイム配信イベントのプッシュ受信のために受信するアドレスのドメイン検証をGoogle Webマスターツールで行う必要がありましたが、現在はドメイン検証を要求しません。

  • Google Cloud Pub/Sub Consoleに移動

    • Google Playアプリにリンクされたプロジェクトを正しく選択する必要があります。
    • トピック(Topic)メニューから新しいトピックを作成します。
    • トピックIDは管理しやすい任意の名称を使用してください。

購読情報配信設定 購読情報配信設定

  1. 作成したトピックにメインメンバーを追加を行います。
    • 詳細メンバー情報google-play-developer-notifications@system.gserviceaccount.comを入力
    • 役割掲示/購読 > 掲示/購読掲示者を選択

購読情報配信設定 購読情報配信設定

  1. 購読メニューに移動し、IAPサーバーに伝える購読を作成します。

    • 購読IDは管理しやすい値を入力
    • Cloud Pub/Subトピックを選択:前に作成したトピックを選択
    • 転送タイプ:プッシュ選択
    • エンドポイントURL:https://api-iap.cloud.toast.com/callback/subscription/{YOUR_PACKAGE_NAME}/GG入力
    • {YOUR_PACKAGE}部分にはNHN Cloud App設定のStoreAppIDに入力した値と同じアプリビルド時に使用したパッケージ名を入力します。

    購読情報配信設定 購読情報配信設定

  2. テスト用のGamebaseサンドボックス環境を使用する場合は、ステップ3の購読をサンドボックス用に作成する必要があります。

    • GamebaseサンドボックスエンドポイントURL入力:https://sandbox-api-iap.cloud.toast.com/callback/subscription/{YOUR_PACKAGE_NAME}/GG
  3. Google Play Consoleのアプリダッシュボードに移動
    • 収入創出設定設定 > Google Play決済画面のリアルタイム開発者通知トピック名にステップ1で作成したトピックの全体名称を入力

購読情報配信設定

TOP