KappSナレッジベース · FAQ

Google Play 課金ライブラリのバージョン要件

FAQ 収益化・支払い

1. GoogleはPlay Billing Libraryに2年間の非推奨化サイクルを設けています。各メジャーバージョンはリリース後2年間サポートされ、その後はPlay Consoleがそのバージョンでコンパイルされた新しいビルドを受け付けなくなります。公開されている表(https://developer.android.com/google/play/billing/deprecation-faq)は次のとおりです。5.xの新規アプリとアップデートの最終日は2024-08-31(延長申請の期限2024-11-01)、6.xは2025-08-31 / 2025-11-01、7.xは2026-08-31 / 2026-11-01、8.xは2027-08-31 / 2027-11-01。実務上は、2026年8月31日以降、Play Billingを使用する新規アプリやアプリ更新はBilling Library 8.0.0以降でビルドする必要があります。

2. 正確な文言が重要です。Googleの非推奨化FAQは、この非推奨化が「新しいアプリと更新が古いバージョンのPlay Billing Libraryを使用することだけを防ぐ。非推奨バージョンのライブラリを使用する既存アプリは、期待どおりに動作し続ける」と述べています。これは公開の関門であり、実行時の強制停止スイッチではありません。すでに公開済みのv7ビルドは購入処理を続けます。失うのは新しいものを公開する能力で、セキュリティパッチや再ビルドも含まれます。そのため、メンテナンスを続ける予定のアプリはすべて移行が必要です。

3. 延長はあくまで申請であり、自動的な猶予期間ではありません。7.x系の場合、延長申請の期限は2026-11-01で、元の期限より前に申請する必要があります。アプリが非推奨バージョンになると、Play Consoleはアプリページの警告とポリシーステータスページの受信トレイメッセージで対象であることを示します。延長フォームは、その警告または問題の詳細ページにあります(https://developer.android.com/google/play/billing/release-notes)。

4. 検出の罠:Play Consoleは、ライブラリがマニフェストに注入するcom.google.android.play.billingclient.versionエントリからライブラリのバージョンを読み取ります。マルチモジュールプロジェクトのマニフェストマージではこのエントリが落ちることがあり、最終的にマージされたマニフェストにそれがなければ、Play Consoleはどのバージョンを出荷したのか判別できず、警告が届かない可能性があります。沈黙を信じず、マージ後のマニフェストを確認してください。

5. v8で壊れるもの(置き換えるまでコンパイルエラーになります):querySkuDetailsAsync() -> queryProductDetailsAsync(QueryProductDetailsParams, ProductDetailsResponseListener)、引数なしのenablePendingPurchases() -> enablePendingPurchases(PendingPurchasesParams)、queryPurchasesAsync(String skuType, PurchasesResponseListener)オーバーロード -> queryPurchasesAsync(QueryPurchasesParams, PurchasesResponseListener)、queryPurchaseHistoryAsync()にはクライアント側の代替がないため購入履歴はサーバー側で追跡する必要があります、BillingClient.Builder.enableAlternativeBilling()、AlternativeBillingListener、AlternativeChoiceDetails -> enableUserChoiceBilling(UserChoiceBillingListener)、UserChoiceBillingListener、UserChoiceDetails、そしてProductDetailsResponseListener.onProductDetailsResponse()は、取得済みと未取得の商品を商品ごとのステータスコードで区別するQueryProductDetailsResultを返すようになりました。用語も変わりました。ドキュメントで「アプリ内アイテム」と呼ばれていたものは「単発商品」になり、v8ではサブスクリプションと同様に複数の購入オプションとオファーをサポートします。

6. 実践チェックリスト:8.0.0ではなく8.x系の最新パッチを固定する。ロールアウト前にライセンステスターで購入・復元・保留中の購入の各フローを再テストする。購入トークンの検証はサーバー側で続ける。そしてこれを一度きりの作業ではなく毎年のメンテナンス項目として扱う——8.x系自体も2027-08-31で新規アップロード不可となり、2027-11-01の延長措置が最後の砦となる。各移行を期限の四半期前にスケジュールすることだけが、リリースを止めない唯一の方法だ。