Google Play 2026年の課金ライブラリ
何かを販売するAndroidアプリ——サブスクリプション、買い切りのアンロック、コインパック——は、すべてGoogle PlayのBilling Libraryのコピーを内包しています。このライブラリは永久ではありません。Googleは各メジャーバージョンを2年という固定のサイクルで廃止し、廃止されるとアプリは動作し続けてもアップデートを配信できなくなります。2026年8月31日時点のサポート対象の最小バージョンはPlay Billing Library 8であり、バージョン7以前でビルドされたすべてのリリースには残された猶予が1つだけあります。2026年11月1日の延長期限です。
本記事はその移行の実務版です。非推奨化の表が現時点で実際に何を定めているのか、特定のAPKがどのバージョンを搭載しているかを確認する方法、7から8または9へ一気に上げたときにコンパイルを壊すAPI名の変更点、延長申請フォームの場所、そしてビルドをリリースする前にテストすべき項目を解説します。
この移行を決める4つの数字: 2年 — Googleが2019年のI/Oでこのポリシーを発表して以来、Play Billing Libraryのすべてのメジャーバージョンに適用されてきた非推奨化サイクルです。2026年8月31日 — 新規アプリと更新がバージョン8以降を使わなければならない期限です(これがv7の期限です)。2026年11月1日 — 同じバージョンの延長期限です。8 — 現在Google Playが新規リリースで受け入れる最低バージョンです。
1. 期限の実際の現状
Google自身のPlay Billing Libraryバージョン非推奨化ページのバナーにはこうあります。「2026年8月31日までに、すべての新規アプリおよび既存アプリのアップデートはBilling Libraryバージョン8以降を使用する必要があります。アプリの更新にもっと時間が必要な場合は、2026年11月1日まで延長を申請できます。」この一文がルールのすべてであり、混同されがちな2つの部分から成っています。
前半は削除ではなく出荷制限です。廃止されたバージョンを依然として含むアプリは、すでにインストールしたユーザーに対しては動作し続けますが、Playは新しいリリースを受け付けません。非推奨化のFAQはその当然の帰結を明言しています。メンテナンスされていないAPKは更新する必要がない一方、新規アプリと更新はサポート対象のバージョンを使用しなければなりません。つまりリスクの性質は「アプリがストアから消える」ことではなく、「これが完了するまで、修正版も、新しいストア掲載情報の実験も、コンプライアンス更新も出荷できない」ということです。
後半が逃げ道となるのが、延長申請です。これはPlay Console内から申請し、新たなカウントダウンではなく同じ固定の期日に対して認められます。そのため、2026年9月下旬時点でなおv7を使っている人にとって現実的な問題は、時間があるかどうかではなく、延長申請をすでに提出済みかどうかです。
2. 非推奨化のスケジュールは固定されており、事前に公開されています
Googleは非推奨化の全スケジュールを公開しており、警告ではなくスケジュールとして読む価値があります。各メジャーバージョンには「新規アプリとアップデート」の期限が8月31日、延長期限が2年後の11月1日に設定されています。
- バージョン5 — 新規アプリと更新の期限は2024年8月31日、延長期限は2024年11月1日。
- バージョン6 — 2025年8月31日、延長は2025年11月1日。
- バージョン7 — 2026年8月31日、延長は2026年11月1日。
- バージョン8 — 2027年8月31日、延長は2027年11月1日。
- バージョン9 — 2028年8月31日、延長は2028年11月1日。
そこから2つの結論が導かれます。第一に、2025年にすでに2バージョン遅れていたアプリは今や3バージョン遅れており、作業量は当時と変わりません。第二に、これは一度きりのプロジェクトではなく恒久的な保守項目であり、今回どのバージョンを選んでも2年以内にまたここへ戻ってきます。通常のリリースサイクルに合わせて更新を計画する方が、Consoleの警告に対応するより安上がりです。
3. ステップ1 — リリースが実際に何を同梱しているかを確認する
まずbuild.gradleを確認します。Billing Libraryはcom.android.billingclient:billingへの依存関係として宣言されており、そのバージョン文字列が答えになります。
dependencies { def billingVersion = "8.3.0" implementation "com.android.billingclient:billing:$billingVersion" }
非推奨化のFAQには重要な詳細が一つ加えられています。これらの依存関係は、com.android.vending.BILLING権限を要求するAPKにのみ現れます。マルチモジュールのプロジェクトや、一部のアプリが古い共有モジュールを使っているポートフォリオでは、問題のあるビルドは課金を宣言しているビルドであり、必ずしもあなたが思い浮かべているアプリとは限りません。課金を含めて出荷するすべてのバンドルを監査しましょう。決済コードを書いた記憶があるものだけでは不十分です。
頑固な警告の理由を説明する、もう一つの確認方法があります。Playは、マージ後のAndroidManifest.xml内のcom.google.android.play.billingclient.version属性からライブラリのバージョンを特定します。依存関係をすでにアップグレードしたのにConsoleが依然として非推奨バージョンを報告する場合、公式ガイダンスではこの属性が存在することを確認するよう求めています。属性が消える原因は、たいていマニフェストのマージです。
4. ステップ2 — ターゲットを選ぶ:バージョン8かバージョン9か
要件は「バージョン8以降」であり、8.xと9.xのどちらもこれを満たします。トレードオフは現実のものなので、意図的に選択してください。
- バージョン8 — 2025年6月30日リリース。8.x系は2025年12月23日の8.3.0で完結した。差分はより小さく、コードがv7にあるならコンパイルエラーは少数で機械的だ。
- バージョン9 — 9.0.0は2026年5月19日、9.1.0は2026年6月18日にリリース。最新のAPIを備え、
targetSdkVersionを35に更新します。これは、Playの対象APIレベルポリシーですでに対応しているAPIレベルの要件と照らし合わせて検討する価値があります。
次のサイクルを見据えて読んでいる方へ。v8自体の期限は2027年8月31日で、延長されて2027年11月1日です。今9.1.0へ移行すれば最も長い猶予を確保でき、v9移行ガイドは7や8から直接来たチーム向けに書かれています。
5. ステップ3 — v7 → v8 の移行作業そのもの
Play Billing Library 8の公式移行ガイドによると、アップグレードは3つの手順と任意の作業で完了します。
ステップ1:依存関係を引き上げる。 com.android.billingclient:billing を8.0.0以降に向ける(理由がなければ.0リリースではなく、その系の最新パッチを使う)。
移行その2:名前が変わったサブスクリプションAPIに対応します。PBL 6から移行するとコンパイルが通らなくなる呼び出しで、代替はそのまま置き換えられるリネームです。
setOldSkuPurchaseToken→setOldPurchaseTokensetReplaceProrationMode→setSubscriptionReplacementModesetReplaceSkusProrationMode→setSubscriptionReplacementMode
移行その3:queryProductDetailsAsyncを修正します。ProductDetailsResponseListener.onProductDetailsResponseにシグネチャの変更があり、実装側でコードの変更が必要です。シグネチャ以上に重要なのはその背後にある動作の変更です。8.0.0より前は、取得できなかった商品は単に返されませんでしたが、PBL 8では商品レベルの新しいステータスコードを伴って返され、その理由(商品が見つからない、そのユーザーに利用可能なオファーがないなど)を示します。以前のUIが「このユーザーは対象外」という推測を無応答から行っていたなら、今後は推測せずにステータスを読み取る必要があります。
PBL 8でも削除されました。コードがまだいずれかを呼び出している場合: queryPurchaseHistoryAsync(購入履歴のクエリにある代替手段を使用)、querySkuDetailsAsync(queryProductDetailsAsyncを使用)、引数なしのenablePendingPurchases()(enablePendingPurchases(PendingPurchaseParams)を使用)、および旧queryPurchasesAsync(String skuType, PurchasesResponseListener)オーバーロードです。v6以前から直接v8に移行する読者は、enableAlternativeBilling / AlternativeBillingListener / AlternativeChoiceDetailsからも移行する必要があり、これらはenableUserChoiceBilling / UserChoiceBillingListener / UserChoiceDetailsに置き換えられました。
任意ですが、導入する価値はあります。 BillingClient.Builder.enableAutoServiceReconnection()を使えば、切断後にstartConnection()を再度呼び出すことなく、ライブラリがPlay Billingサービスの接続を自力で再確立します。これはAndroidで「購入ボタンが反応しない」という報告の最も一般的な原因です。同じリリースでは、プリペイドプランと仮想分割払いサブスクリプションの保留中購入のサポートも追加されています。
6. ステップ4 — あるいは9.1.0まで一気に進む
The migration guide for Play Billing Library 9 covers teams coming from 7 or 8. Beyond the dependency bump to 9.1.0, the recurring theme is that the legacy SKU vocabulary finally disappears (BillingClient.SkuType → ProductType, SkuDetails → ProductDetails, SkuDetailsParams → QueryProductDetailsParams, SkuDetailsResponseListener → ProductDetailsResponseListener, getSkuDetailsList/setSkuDetailsList → setProductDetailsParamsList), and one change lands directly on subscription revenue logic:
ユーザーが無料トライアルの対象かどうかを
queryPurchaseHistoryAsyncで判断していた場合、ガイドではProductDetails.getSubscriptionOfferDetails()を使ってユーザーが対象となるオファーを特定するよう推奨しています。
v9の小さな変更が3つあり、見落とされがちです。Playストアがブロックされた場合の処理でレスポンスコードが変わりました。Playストアアプリ自体がブロックされている場合(例:OEMのキッズモード)、結果コードはERRORからBILLING_UNAVAILABLEへと変わり、「Play Store is blocked」というデバッグメッセージが付きます。これが正しく動作するにはandroidx.coreバージョン1.9以降が必要です。DeveloperProvidedBillingDetails.getLinkUri()は@Nullableになったため、nullおよび空文字のチェックなしにそのURIを起動するコードはクラッシュします。さらに9.0.0では、オプトインの値上げに対するアプリ内メッセージングが追加され、アプリを離れることなく未払いの値上げ額をユーザーに表示できます(メッセージは7日に1回まで)。
7. ステップ5 — 必要な場合の延長申請フォーム
アプリがまだサポート対象外のバージョンで配信されている場合、Play Consoleは警告を表示します。延長申請は警告の詳細ページから行います。ポリシーステータスを開き、警告を開き、そこにリンクされている延長申請フォームを使用してください。公式にはこれが唯一のルートです。メールでの申請はできず、該当バージョンについて公表されている11月1日以降の再延長もありません。
すでに固定された期限内のリリース余裕として捉え、追加の猶予とは考えないでください。延長を申請しても、作業は2026年11月1日までに完了させる必要があり、それ以降はv7での新規リリースは受け付けられなくなります。まったく無関係なポリシーのために待っているコンプライアンスリリースも含まれます。
8. ステップ6 — 出荷前に確認する
課金の不具合はクラッシュとしては現れません。購入できない有料ユーザーとして現れます。リリースを製品版に出す前に:
- Playストアが実際にインストールされた端末でライセンステスターを使い、実際の購入、サブスクリプションのアップグレードとダウングレード、復元を一通り実行してください。Playストアのないエミュレーターでは、変更した接続処理を検証できません。
- 商品詳細の呼び出しが、取得できなかった商品をステータスコード付きで返すこと、そしてUIが「見つからない」と「このユーザーに利用可能なオファーがない」で正しいメッセージを表示することを確認してください。
- リリース後、Play Consoleで非推奨化の警告が消えること、およびマージ後のマニフェストに
com.google.android.play.billingclient.version属性が存在することを確認してください。 - 段階的にリリースして、課金の不具合が全ユーザーではなく一部のユーザーにのみ届くようにし、より高いバージョンコードを置き換え用に用意しておきます。
9. 新しいバージョンが収益面でもたらすもの
移行は有償の作業なので、新しいライブラリが何を可能にするかを数えるのは妥当です。PBL 8.0.0は「アプリ内アイテム」を単発商品に改名し、それらに複数の購入オプションとオファーを追加しました。これにより、同じものを異なる価格帯で販売するために作成する個別商品の数を減らせます。またlaunchBillingFlow()にサブレスポンスコードを追加しました:PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS、USER_INELIGIBLE(ユーザーがサブスクリプションオファーの設定済み適格要件を満たしていない)、そしてデフォルトのNO_APPLICABLE_SUB_RESPONSE_CODE — 曖昧な「問題が発生しました」と、ユーザーにカードへのチャージを促す画面との違いです。
8.2.xおよび8.3.0リリース(2025年12月)では外部コンテンツリンク、外部オファー、外部決済のAPIが追加され、9.1.0ではBilling Choice APIが追加されました。ロードマップにこれらのプログラムが含まれている場合、バージョンアップは別プロジェクトではなく前提条件です。すでにこのコードに取り組んでいるうちに9.1.0へ上げるべき、というのが実務上の理由です。
情報源
デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。
メッセージを受け付けました。24時間以内に返信します。
← 編集に戻る