Google Playの問題

0:10:00

Google Playの設定に関する問題は、RevenueCatをAndroidアプリと連携する際に最もよく発生する問題のひとつです。このステップでは、商品の設定、サービス認証情報、テスト中によく直面する課題を取り上げます。

問題1：商品が見つからないエラー

エラーメッセージ

text
BillingClient: Product not found
Error: The item you were attempting to purchase could not be found

よくある原因

  1. 商品が未公開：商品は存在するものの、Google Play Consoleで公開されていない場合です。
  2. 商品IDの不一致：RevenueCatの商品IDがGoogle Playと一致していません。
  3. アプリが未公開：アプリが公開されていません（内部テスト向けにも公開されていない状態です）。
  4. パッケージ名の誤り：パッケージ名がアプリと一致していません。

解決手順

手順1：Google Play Consoleで商品のステータスを確認する

  1. Google Play Consoleに移動します。
  2. Monetize → Products → In-app productsまたはSubscriptionsに移動します。
  3. 商品のステータスが「Active」になっているか確認します。
  4. 「Inactive」または「Draft」と表示されている場合は、有効化する必要があります。

手順2：商品IDが一致しているか確認する

  1. Google Play Consoleから正確な商品IDをコピーします。
  2. RevenueCatダッシュボードに移動します。
  3. Product Catalog → Productsに移動します。
  4. Google Playの商品IDと完全に一致しているか確認します（大文字と小文字は区別されます）。
重要： 商品IDは大文字と小文字を区別します。「premium_monthly」と「premium_Monthly」は別物です。

手順3：テスト用にアプリを公開する

  1. アプリは少なくとも内部テストトラックに公開されている必要があります。
  2. Google Play ConsoleでTesting → Internal testingに移動します。
  3. リリースを作成し、APK/AABをアップロードします。
  4. 自分自身をテスターとして追加します。
  5. Google Playがリリースを処理するまで1〜2時間ほど待ちます。

手順4：パッケージ名を確認する

  1. アプリのbuild.gradleでapplicationIdを確認します。
  2. RevenueCatダッシュボードのApp → Google Playでパッケージ名が一致しているか確認します。

問題2：サービス認証情報 / APIアクセスの問題

エラーメッセージ

text
Error: Unable to fetch Google Play purchases
Google Play credentials are invalid or expired

よくある原因

  1. サービスアカウントが未作成：Google Cloudのサービスアカウントを設定していません。
  2. 権限の不足：サービスアカウントに必要な権限がありません。
  3. 認証情報の期限切れ：サービスアカウントキーの有効期限が切れています。
  4. 誤ったプロジェクトの連携：サービスアカウントが別のGoogle Cloudプロジェクトのものです。

解決手順

手順1：サービスアカウントを作成する（未作成の場合）

  1. Google Cloud Consoleに移動します。
  2. Google Play Consoleに連携されているプロジェクトを選択するか、新規作成します。
  3. IAM & Admin → Service Accountsに移動します。
  4. Create Service Accountをクリックします。
  5. 名前を「RevenueCat Service Account」にします。
  6. Create and Continueをクリックします。
  7. ロールの割り当てはスキップします（Google Play Console側で行います）。
  8. Doneをクリックします。

手順2：Google Play Consoleで権限を付与する

  1. Google Play Consoleに移動します。
  2. Setup → API accessに移動します。
  3. Google Cloudプロジェクトを連携します（まだ連携されていない場合）。
  4. サービスアカウントを見つけてGrant accessをクリックします。
  5. 次の権限を付与します。
    • View financial data。
    • Manage orders and subscriptions。
  6. Invite userをクリックします。

手順3：サービスアカウントキーを生成してアップロードする

  1. Google Cloud Consoleで作業します。
  2. IAM & Admin → Service Accountsに移動します。
  3. サービスアカウントをクリックします。
  4. Keysタブに移動します。
  5. Add Key → Create new keyをクリックします。
  6. JSON形式を選択します。
  7. キーファイルをダウンロードします。
  8. RevenueCatダッシュボードで次の手順を行います。
    • プロジェクトに移動します。
    • Apps & providers → Google Playに移動します。
    • JSONキーファイルをアップロードします。
セキュリティに関する警告： サービスアカウントのJSONファイルは絶対にバージョン管理システムにコミットしないでください。安全に保管し、キーを定期的にローテーションしてください。

問題3：テストの問題とライセンステスター

エラーメッセージ

text
Error: This version of the application is not configured for billing through Google Play

よくある原因

  1. ライセンステスターとして未登録：Googleアカウントがライセンステストのリストにありません。
  2. 誤ったGoogleアカウントの使用：ライセンステスターではないアカウントでテストしています。
  3. 適切な設定のないエミュレーターでのテスト：エミュレーターには別途設定が必要です。
  4. Playストアからダウンロードしていないアプリ：サイドロードしたアプリではテスト購入ができません。

解決手順

手順1：ライセンステスターを追加する

  1. Google Play Consoleに移動します。
  2. Setup → License testingに移動します。
  3. テスターのGmailアドレスを追加します。
  4. レスポンスをRESPOND_NORMALLYに設定します。
  5. 変更を保存します。

手順2：内部テストのユーザーを追加する

  1. Testing → Internal testingに移動します。
  2. Testersタブでリストを作成するか、メールアドレスを追加します。
  3. テスターはプログラムに参加するために、オプトインリンクを承認する必要があります。

手順3：アプリを正しくインストールする

  1. テスターはPlayストアのオプトインリンクからインストールする必要があります。
  2. 購入テストのためにAPKをサイドロードしないでください。
  3. デバイスがライセンステスターのGoogleアカウントでログインしているか確認します。

手順4：バージョンコードが一致しているか確認する

  1. アップロードしたAPK/AABのバージョンコードは、ローカルビルドと一致している必要があります。
  2. build.gradleでversionCodeを確認します。
  3. Google Play Consoleのバージョンと一致しているか確認します。
ヒント： Google Playの設定の手間をかけずに、より速く安定したテストを行うには、RevenueCat Test Storeを使用してください。

問題4：キャッシュと状態の問題

症状

  • 正常に動作していた商品が突然利用できなくなります。
  • 購入に成功しても購入状態が更新されません。
  • 削除した古い商品が表示され続けます。

解決手順

手順1：Google Playストアのキャッシュを削除する

  1. デバイスのSettings → Appsに移動します。
  2. Google Play Storeを見つけます。
  3. Storage → Clear Cacheをタップします。
  4. デバイスを再起動します。

手順2：アプリのキャッシュを削除する

kotlin
// 顧客情報を強制的に再取得する
Purchases.sharedInstance.invalidateCustomerInfoCache()

手順3：アプリを再インストールする

  1. アプリを完全にアンインストールします。
  2. Playストアのオプトインリンクから再インストールします。
  3. これによりクリーンな状態が保証されます。

問題5：内部テスト中に実際の請求が発生する（テスト取引にならない）

症状

Google Playの内部テストトラックでサブスクリプションやアプリ内購入をテストしているのに、支払い方法（クレジットカード、UPI、Google Payなど）に実際の請求が発生します。Google Playの決済ダイアログに「Test card, always approves」オプションの代わりに実際の支払いオプションが表示され、取引が本番の購入として記録されます。

発生する理由

多くの開発者が見落とす非常に重要な区別があります。内部テストのテスターとライセンステスターは、Google Play Consoleにおいて完全に別の2つの設定です。

設定場所役割
内部テストのテスターTesting → Internal testing → Testersタブテストトラックからアプリをダウンロードできる権限を付与します。
ライセンステスターSetup → License testing購入をテスト取引として処理します（実際の請求は発生しません）。

ユーザーを内部テストのテスターとして追加すると、アプリをダウンロードできるようになるだけです。これによって購入が無料になることはありません。購入をテスト取引として処理するには、License testingにも必ず該当のGmailアドレスを追加する必要があります。

警告： ライセンステストを設定していない場合、アプリ自体がテストトラックにあっても、内部テストトラックで発生するすべての購入は実際にお金が請求される本番の取引になります。

解決手順

手順1：テスターをLicense testingに追加する（アカウントレベル）

最も見落とされやすい手順です。

  1. Google Play Consoleに移動します。
  2. Setup → License testingに移動します（アプリごとの設定ではなく、アカウントレベルの設定にあります）。
  3. 各テスターのGmailアドレスを追加します。
  4. ライセンスレスポンスをRESPOND_NORMALLYに設定します。
  5. Save changesをクリックします。
  6. 変更が反映されるまで15〜30分ほど待ちます。
注意： GmailアドレスはテストデバイスのメインのGoogleアカウントと一致している必要があります。デバイスに複数のGoogleアカウントがある場合は、Playストアからインストールする際に使用したアカウントが重要です。

手順2：デバイスで正しいGoogleアカウントを確認する

ライセンステストを設定していても、デバイスで誤ったアカウントを使用すると実際の請求が発生します。

  1. テストデバイスでGoogle Play Storeアプリを開きます。
  2. 右上のプロフィールアイコンをタップします。
  3. どのGoogleアカウントがアクティブになっているか確認します。
  4. このアカウントはLicense testingに登録したメールアドレスと同じである必要があります。
  5. 複数のアカウントを使用している場合は、購入する前に正しいアカウントに切り替えます。

手順3：オプトインリンクからアプリを再インストールする

アプリは正しいテストチャネルを通じてインストールする必要があります。

  1. デバイスからアプリをアンインストールします。
  2. Google Play Console → Testing → Internal testing → Testersタブに移動します。
  3. オプトインURL（「Join on the web」リンク）をコピーします。
  4. 正しいGoogleアカウントを使って、テストデバイスでこのリンクを開きます。
  5. 招待を承認し、Playストアからアプリをインストールします。

手順4：テストモードが機能しているか確認する

ライセンステストが正しく設定されていれば、決済ダイアログに次が表示されます。

  • 上部に「Test card, always approves」という支払い方法が表示されます。
  • 購入金額が$0.00と表示されるか、テスト注文として表示されます。
  • 実際の支払い方法（クレジットカード、UPI、Google Pay）がデフォルトのオプションとして表示されないはずです。

すべての手順に従っても実際の支払いオプションが表示され続ける場合は、30分ほど待ってから再試行してください。ライセンステストの変更がGoogleのシステムに反映されるまで時間がかかることがあります。

誤って発生した実際の請求の返金を受ける

テスト中に実際にお金が請求された場合は、返金を行うことができます。

方法1：Google Play Console経由での返金（開発者向け）

  1. Google Play Consoleに移動します。
  2. Order management（Monetizeの下）に移動します。
  3. ユーザーのメールアドレスまたは注文IDで注文を探します。
  4. 注文をクリックしてRefundを選択します。
  5. 返金を選択し、必要であればアクセス権を取り消します。

方法2：Google Playサポート経由での申請（テスター向け）

  1. Google Playの注文履歴を開きます。
  2. 該当の請求を見つけてReport a problemをクリックします。
  3. 理由を選択して返金を申請します。
ヒント： 誤請求を完全に避けるには、Google Playのライセンステストの代わりにRevenueCatのTest Storeの利用を検討してください。Test Storeは実際の請求リスクのない決定的なテスト取引を提供し、特別なアカウント設定が不要で、CI/CD環境でも動作します。

よくある問題のクイックリファレンス

問題考えられる原因解決方法
RevenueCatで商品が見つからない Google Play ConsoleとRevenueCatダッシュボード間の商品IDの不一致。 Google Play Console → Monetize → Productsから正確な商品IDをコピーします。RevenueCat → Product Catalog → Productsに貼り付けます。IDは大文字と小文字を区別し、一字一句正確に一致している必要があります。
RevenueCatで商品が見つからない 商品がGoogle Play Consoleで「Draft」または「Inactive」状態になっています。 Google Play Console → Monetize → Productsで各商品のステータスがActiveと表示されているか確認します。Draft状態の商品を有効化し、変更が反映されるまで数分待ちます。
RevenueCatで商品が見つからない アプリがどのテストトラックにも公開されていません。 アプリは署名済みのAPK/AABとともに、少なくとも内部テストトラックに公開されている必要があります。Google Play Console → Testing → Internal testing → Create new releaseに移動します。
「Billing unavailable」エラー Google Play開発者サービスのないエミュレーターでテストしています。 実機か、Google Playストアを含むエミュレーターイメージを使用してください（Google APIのみでは不十分です）。Android Studioで「Google Play」列が表示されているシステムイメージを選択します。
「Billing unavailable」エラー アプリがPlayストアを経由せずサイドロードされています。 テスターは内部テストトラックのPlayストアのオプトインリンクからアプリをインストールする必要があります。サイドロードしたAPKではテスト購入ができません。
サービス認証情報エラー サービスアカウントのJSONキーがアップロードされていないか、期限切れです。 RevenueCatダッシュボード → Apps & providers → Google Playで有効なJSONキーファイルをアップロードします。必要であれば、Google Cloud Console → IAM & Admin → Service Accounts → Keysで新しいキーを生成します。
サービス認証情報エラー サービスアカウントに必要な権限がありません。 Google Play Console → Setup → API accessで、サービスアカウントにView financial dataとManage orders and subscriptionsの権限を付与します。反映まで最大36時間かかることがあります。
サービス認証情報エラー Google CloudプロジェクトがPlay Consoleに連携されていません。 Google Play Console → Setup → API accessで、サービスアカウントを含む正しいGoogle Cloudプロジェクトを連携します。一度に連携できるプロジェクトは1つだけです。
「This version is not configured for billing」 ローカルビルドとPlayストア間のバージョンコードの不一致。 build.gradleのversionCodeがテストトラックにアップロードされたバージョンと一致しているか確認します。異なる場合は新しいビルドをアップロードします。
テスト購入で実際のお金が請求される Googleアカウントがライセンステスターとして追加されていません（アカウントレベルの設定）。 Google Play Console → Setup → License testing（アプリレベルのテスターではありません）に移動します。Gmailアドレスを追加します。レスポンスをRESPOND_NORMALLYに設定します。15〜30分ほど待ちます。内部テストのテスターとライセンステスターは別個の設定です。上記の詳細ガイドを参照してください。
テスト購入で実際のお金が請求される デバイスで誤ったGoogleアカウントがアクティブになっています。 デバイスのメインのGoogleアカウント（Playストアからインストールする際に使用したアカウント）は、License testingのメールアドレスと一致している必要があります。Playストアを開き → プロフィールアイコンをタップしてアクティブなアカウントを確認します。複数のアカウントがある場合は正しいアカウントに切り替えます。
テスト購入で実際のお金が請求される ライセンステストの変更がまだ反映されていません。 ライセンステスターを追加した後、テストする前に15〜30分ほど待ちます。Google Playストアのキャッシュを削除し（Settings → Apps → Google Play Store → Clear cache）、デバイスを再起動すると反映が早まることがあります。
商品に古いデータが表示され続ける デバイスのGoogle Playストアのキャッシュが古くなっています。 デバイスでSettings → Apps → Google Play Store → Storage → Clear Cacheに移動します。その後、Playストアを強制終了してアプリを再度開きます。
購入は成功するのにエンタイトルメントが付与されない RevenueCatでエンタイトルメントが商品に紐付けられていません。 RevenueCatダッシュボード → Product Catalog → Entitlementsで、エンタイトルメントが存在し、商品が紐付けられているか確認します。各商品は少なくとも1つのエンタイトルメントに紐付けられている必要があります。
サブスクリプションの更新が検出されない Googleのリアルタイムデベロッパー通知が設定されていません。 Googleリアルタイムデベロッパー通知を設定し、RevenueCatがサブスクリプションの状態更新を即座に受け取れるようにします。
サブスクリプションを取得できない（新しいPlayモデル） 基本プランが「Backwards compatible」としてマークされていません。 Google Play Consoleでサブスクリプションを開き、基本プランをクリックします。「Backwards compatible」タグが有効になっているか確認します。サブスクリプションごとにBackwards compatibleにできる基本プランは1つだけです。RevenueCatではsubscriptionId:basePlanId形式を使用します。コミュニティディスカッションを参照してください。
「You already own this item」 以前のテスト購入が消費も返金もされていません。 非消耗型商品の場合は、Google Play Consoleを通じて購入を返金して取り消します。RevenueCatダッシュボードでテストユーザーを削除し、サンドボックスの状態をリセットします。消耗型商品の場合は、SDKが購入を正しく消費するようにします。コミュニティディスカッションを参照してください。
「The item you requested is not available for purchase」 アプリがflutter runでローカル実行されたか、サイドロードされています。 署名済みのアプリをGoogle Playのテストトラックにアップロードして承認を受けます。テスターはオプトインリンクからインストールする必要があります。Playストアでの配信なしに、ローカルのデバッグビルドでは購入をサポートできません。コミュニティディスカッションを参照してください。
商品取得時にSERVICE_UNAVAILABLEが発生する BillingClientの接続がまだ完了していません。 デバイスにGoogle Play開発者サービスがインストールされ、最新の状態であることを確認します。SDKは自動的に再試行します。configure()の直後にオファリングを取得しないでください。RevenueCat SDKを最新バージョンに更新します。コミュニティディスカッションを参照してください。

Google Play設定のクイックチェックリスト

このチェックリストでGoogle Playの設定を確認してください。

  • ☐ Google Play Consoleで商品がActive状態になっています。
  • ☐ Google PlayとRevenueCat間で商品IDが正確に一致しています。
  • ☐ アプリが少なくとも内部テストトラックに公開されています。
  • ☐ build.gradleとRevenueCatのパッケージ名が一致しています。
  • ☐ サービスアカウントを作成し、JSONキーをRevenueCatにアップロードしました。
  • ☐ Google Play Consoleでサービスアカウントに正しい権限があります。
  • ☐ Google Play Consoleにライセンステスターを追加しました（Setup → License testing、アプリレベルのテスターではありません）。
  • ☐ 実機で正しいGoogleアカウントを使ってテストしています。
  • ☐ Playストアのオプトインリンクからアプリをインストールしました（サイドロードではありません）。