Google Play のすべてのアップデートに Play Billing Library 8 が必須となり、返金の追跡はサーバー側に移ります
Play Billing Library 7 に対する Google の延長期限は 2026年11月1日に終了し、新規アプリとアップデートにはバージョン 8 以降が必要になりました。バージョン 8 では queryPurchaseHistory() が削除されたため、返金済みや消費済みの購入はサーバー側で追跡しなければなりません。何が変わったのか、移行の遅れが何をもたらすのかを解説します。

要点
- Google の非推奨スケジュールでは、Play Billing Library 7 で新規アプリとアップデートを公開できる最終日を 2026年8月31日とし、延長は 2026年11月1日に終了しました。そのため現在、Google Play のアップデートには Play Billing Library 8 以降が必要です。
- すでに Play Billing Library 7 で公開中のアプリはそのまま動作します。Google によれば、非推奨化で止まるのは新規アプリとアップデートだけで、既存のインストールには影響しません。
- Play Billing Library 8 では queryPurchaseHistory() が削除されました。Google が示す代替策はサーバー側にあります。消費済みの購入は自社のバックエンドで追跡し、返金やキャンセルされた購入は Voided Purchases API から取得します。
- Google Play Voided Purchases API が表示する無効化された購入は過去 30 日分のみで、アプリごとに 1 日 6,000 回、任意の 30 秒間に 30 回までのクエリに制限されています。
- アプリが 3 日以内に購入を承認しない場合、Google Play は今も自動的に返金し、利用権を取り消します。Play Billing Library 8 への移行に失敗すると、すべての売上でこれが起きる可能性があります。
- Google Play のチャージバック審査は、開発者に証拠の提出を求める唯一の Android 返金フローです。PendingRefundReviewNotification の受信から 24 時間以内に orders.reviewrefund で回答します。
- 2026年8月3日より後に発生した Google Play の注文では、チャージバックに敗れるたびに、開発者が購入代金(Play のサービス手数料を除く)と銀行のチャージバック手数料を負担します。
Google Play で販売するすべての Android アプリは、次のアップデートで Play Billing Library 8 以降を搭載する必要があります。バージョン 7 の新規アプリとアップデートの期限は 2026年8月31日で、最後の延長も 2026年11月1日に終了しました。日付は Google の非推奨に関する FAQ の表に掲載されており、通知は Play Console の「ポリシーのステータス」ページに警告として届きます。
多くのチームにとっては、依存関係の更新といくつかのメソッド名の変更で済む話です。しかし返金に関しては、それだけでは終わりません。Play Billing Library 8 は、アプリが過去の購入を振り返るための唯一のクライアント呼び出しを削除しました。今後、ユーザーが何を購入し、何を消費し、何が返金されたかを知りたければ、サーバーが記録しておくしかありません。
Play Billing Library 8 の期限で実際に止まるもの
Google は各ライブラリバージョンに 2 年の寿命を設けています。非推奨化で止まるのは新規アプリとアップデートだけです。Google の FAQ によれば、既存のアプリは引き続き動作し、メンテナンスされていない APK を更新する必要もありません。つまり、もう手を入れていないアプリが今日壊れることはありません。壊れるのは、修正や新しい価格、新しいペイウォールを公開しようとしたその日です。
| ライブラリのバージョン | 新規アプリとアップデートの期限 | 延長の期限 |
|---|---|---|
| 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日 |
バージョン 8.0.0 は 2025年6月30日にリリースされました。バージョン 9.0.0 は 2026年5月19日に続きました。今から移行するなら、8 で止めずに 9 まで一気に上げれば、1 年長く使えます。
Play Billing Library 8 が返金にとって重要な理由
最も大きな削除は queryPurchaseHistory() です。バージョン 7 で非推奨となり、バージョン 8.0.0 で削除されました。Google の移行ガイドは、その役割を 3 つに分けています。そのうちデバイス上に残るのは 1 つだけです。
| queryPurchaseHistory() を何に使っていたか | Google が現在推奨する方法 | 実行場所 |
|---|---|---|
| 有効な購入と保留中の購入 | queryPurchasesAsync() | デバイス上 |
| 消費済みの一回限りの購入 | 自社の記録 | 自社のサーバー |
| 返金、キャンセル、チャージバックされた購入 | Voided Purchases API | 自社のサーバー |
| ユーザーの全購入履歴 | 自社の記録 | 自社のサーバー |
Android で消費型の購入はまだ復元できますか?
クライアントからはできません。queryPurchasesAsync() が返すのは有効な購入だけなので、消費済みのクレジットパックや使い切ったジェムのセットがそこから戻ってくることはありません。ユーザーが再インストールして「コインはどこへ行ったのか」と尋ねてきたら、その答えは購入時に記録しておいた台帳から出すしかありません。購入履歴を無料のバックアップとして頼っていたアプリは、それを失いました。
今後、返金はどうやって把握するのですか?
サーバー側の経路が 2 つあります。リアルタイム デベロッパー通知は VoidedPurchaseNotification を送信します。中身は購入トークン、注文 ID、商品タイプ、そして返金タイプで、返金タイプは全額返金か数量ベースの一部返金のどちらかです。Voided Purchases API を使えば、同じイベントを期間を指定して取得でき、取りこぼしを補う手段になります。
この取得 API には厳しい制限があります。表示される無効化された購入は過去 30 日分だけです。各アプリは 1 日 6,000 回、任意の 30 秒間に 30 回までしかクエリできません。さらに、取り消しオプションを付けずに開発者が行った返金は一切返されません。サーバーが 5 週間止まれば、二度と取り戻せない返金が失われます。

開発者がまだ意見を言える返金
返金の追跡をサーバーに移しても、返金に対する裁量が増えるわけではありません。Google Play の返金のほとんどは、あなたの関与なしに決まります。セルフサービスの返金、サポートによる返金、キャンセル、そして未承認の購入に対する自動返金です。あなたがそれを知るのは事後で、無効化された購入の通知を通じてです。
例外はチャージバック審査です。購入者があなたの意見を必要とするチャージバックを申し立てると、Google は PendingRefundReviewNotification を送信します。Google によれば、24 時間以内に orders.reviewrefund を呼び出し、返金に関する提案と利用状況の証拠を添えて回答すべきです。その証拠は、新しいライブラリが保持を強いるのと同じサーバー記録から得られます。復元のために台帳を管理しているチームなら、回答に必要なものはすでに揃っています。
移行の遅れが招く金銭的なコスト
直接のリスクは 3 日ルールです。アプリが 3 日以内に購入を承認しない場合、Google Play は自動的に返金し、利用権を取り消します。保留中の購入では、購入が PENDING から PURCHASED に変わった時点から期限が始まります。移行で接続ロジック、新しい queryProductDetailsAsync() リスナー、保留中の購入の設定のいずれかが壊れると、売上は止まらないまま承認だけが止まることがあります。その間の注文はすべて全額返金され、しかもユーザーは支払った分をすでに受け取っています。
そこが痛いところです。返金された画像クレジットパックでも、各生成の裏で GPU 時間はすでに消費されています。返金された AI プランでも、有料の API 呼び出しはすでに実行されています。返金されたストレージプランでも、あなたが費用を払うディスクはすでに埋まっています。返金された投げ銭でも、クリエイターへの支払いはすでに済んでいます。返金は売上を購入者に戻し、それらの請求だけをあなたに残します。
チャージバックのコストも上がりました。Google のヘルプセンターによれば、2026年8月3日より後に発生した注文では、開発者が購入代金(Play のサービス手数料を除く)に加えて、銀行のチャージバック手数料を負担します。Google が引き続き負担するのは自社のサービス手数料だけです。実際の利用データでチャージバック審査に 24 時間以内に回答できないアプリは、毎回その全額を支払うことになります。
収益を守るための移行チェックリスト
- 依存関係を Play Billing Library 8 または 9 に上げ、
queryPurchaseHistory()、querySkuDetailsAsync()、引数なしのenablePendingPurchases()を削除する。 queryProductDetailsAsync()リスナーを更新する。バージョン 8 以降は、取得できなかった商品もステータスコード付きで返される。enableAutoServiceReconnection()を有効にし、課金接続が切れても購入処理が止まらないようにする。onResume()でqueryPurchasesAsync()を呼び出し、アプリが閉じている間に完了した購入も 3 日以内に承認されるようにする。- すべての購入トークン、注文 ID、消費をサーバーに記録し、自社のアカウント ID に紐付ける。
- リアルタイム デベロッパー通知を購読し、
VoidedPurchaseNotificationとPendingRefundReviewNotificationの両方を処理する。 - 安全策として Voided Purchases API の同期を毎日実行し、30 日の期間と 1 日 6,000 回のクエリ上限に十分な余裕を持たせる。
RefundHalt は Google Play の無効化された購入とチャージバック審査の通知を受け取り、24 時間の期限内に実際の利用データを使って orders.reviewrefund で各審査に回答します。さらに、アプリがもうデバイスに問い合わせられなくなった返金履歴を保持します。
よくある質問
- 今すぐ Play Billing Library 8 を使わなければなりませんか?
- はい。Google Play の課金で販売する新規アプリやアップデートであれば必要です。Google の非推奨スケジュールではバージョン 7 の期限を 2026年8月31日とし、延長は 2026年11月1日に終了しました。バージョン 8 か、より新しいバージョン 9 を使えます。
- Play Billing Library 7 のままの既存アプリは動かなくなりますか?
- いいえ。Google によれば、既存のアプリは引き続き動作し、メンテナンスされていない APK を更新する必要もありません。非推奨化で止まるのは、サポート対象外のバージョンを使った新規アプリやアップデートの公開だけです。
- Play Billing Library 8 で queryPurchaseHistoryAsync は何に置き換えられましたか?
- デバイス上で同じ役割を果たすものはありません。Google は、有効な購入と保留中の購入には queryPurchasesAsync() を使い、消費済みの購入は自社のサーバーで追跡し、キャンセルや返金された購入には Voided Purchases API を使うよう案内しています。
- Google Play Voided Purchases API はどこまで遡れますか?
- 30 日です。Google によれば、この API が表示できるのは過去 30 日間に発生した無効化された購入だけで、アプリごとに 1 日 6,000 回、任意の 30 秒間に 30 回までのクエリに制限されています。
- アプリが購入を承認しないと、Google Play は返金しますか?
- はい。購入が 3 日以内に承認されない場合、ユーザーには自動的に返金され、Google Play はその購入を取り消します。保留中の購入では、状態が PENDING から PURCHASED に変わった時点から 3 日間が始まります。
出典と参考資料
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
App Store と Google Play の返金を自動処理
続きを読む
ブラジルが子どもにルートボックスを売り続けるゲームの確認を開始。そのツケが回ってくるのはルートボックスの返金です
ブラジル司法省は、年齢確認なしでルートボックスを販売する6つのゲームを監視するよう、データ保護当局に要請しました。法律が何を求めているか、Apple と Google がすでに何を求めているか、そして開封済みのボックスについてルートボックスの返金をどう見積もり、どう対応するかを解説します。
意図しないアプリ内課金は勝てない返金。対策は購入画面にある
誤タップによるアプリ内課金は、どちらのストアでも返金として戻ってきます。そして、そのタップが意図的だったと証明できる利用データはありません。Apple と Google がこれをどうラベル付けするか、コンピュートや支払いでどれだけのコストが生じるか、そして課金が発生する前に防ぐ購入画面の設計を解説します。