google-ultra — Google Play課金APIの挙動を検証するPoCスクリプト
gylive/google-ultra
★ 1,778 ・ Python ・ MIT
概要
google-ultra は、Google Playの課金ライブラリ(BillingClient)内部に存在する特定の試用オファーの挙動を検証するための概念実証(PoC)ツールです。READMEの記述によると、Google One の AI Ultraプラン(20TBなど)において、通常のWebページ上には表示されないものの、Playストアの決済ライブラリ内部で取得可能な「12ヶ月無料試用オファー」が存在するとされています。
本プロジェクトは、クライアント側でそのオファーを取得し、決済フローを呼び出すプロセスを自動化・検証するために作成されています。実装形態として、ブラウザ上で動作するHTMLベースの「簡易版」と、ルート権限を持つAndroid実機やエミュレータと動的解析フレームワーク「Frida」を組み合わせて動作するPythonスクリプト「スクリプト版」の2系統が用意されています。主にAndroidアプリの内部挙動や決済フローのセキュリティ研究を行う技術者やリバースエンジニアに向けた構成となっています。
主な特徴
- 2種類の実装アプローチ: ブラウザから決済画面を直接呼び出す単一のHTMLファイル(Web版)と、Android実機上でFridaを用いてフックするPythonスクリプト版(
ultra0.py)が用意されています。 - BillingClientの直接呼び出し: スクリプト版では、APKの改変やXposedフレームワークを使用せず、Google Oneアプリの実行プロセス内で課金モジュールをロードしてAPIを直接呼び出します。
- オファー情報の自動取得と選定: APIレスポンスから取得した複数のオファーの中から、最も試用期間が長い条件(12ヶ月無料など)を抽出して決済フローを起動します。
- ゼロ円確認機構: 決済画面の表示時に、請求金額が0円または無料試用期間中であることを確認した段階でのみ処理を進め、想定外の即時課金が発生しないよう配慮された安全チェックロジックが組み込まれています。
- 自動化とレポート生成: 複数アカウントの順次処理、アカウント切り替え、決済結果の検証とローカルディレクトリ(
ultra0-report/)へのレポート保存に対応しています。
使い方
本リポジトリには「簡易版(Web)」と「スクリプト版(Python)」の2つの実行方法が記載されています。
1. 簡易版(Webブラウザ)
リポジトリ内の web/index.html をローカル環境のブラウザで開くか、ホストされているWebページにアクセスして利用します。
- 画面上の案内に従って対象のGoogleアカウントでログインします。
- 決済方法(クレジットカードなど)を登録します(試用中の請求は発生しない前提とされています)。
- 画面上のプランカードを選択すると決済画面へ遷移するため、請求金額が「0」であることを確認して手続きを完了します。
2. スクリプト版(Python / Frida)
スクリプト版を利用する場合、ルート化されたAndroid端末(Magisk、KernelSU、APatch、またはエミュレータ)と、PC側の環境構築が必要です。
必要要件
- Python 3.9 以上
- Android SDK platform-tools(
adbが利用可能な状態) - Android端末の「USBデバッグ」が有効化されており、PCと接続されていること
依存パッケージのインストール
pip3 install frida
環境チェックの実行
スクリプトを実行する前に、デバイス接続、root権限、frida-serverの状態、ネットワークプロキシの設定などを検証するチェックコマンドを実行します。
python3 ultra0.py --check
スクリプトの実行
単一のアカウントを指定して実行する場合は以下のコマンドを使用します。
python3 ultra0.py --account "ユーザー名@gmail.com:パスワード:2FAキー"
複数アカウントを記載したテキストファイルを読み込ませて実行することも可能です。アカウント定義ファイルは、各行にアカウント情報や決済カード情報を指定のフォーマット(区切り文字 ----)で記述します。
python3 ultra0.py accounts.txt
オプション引数として、検証対象のプランを指定する --plan(5x / 20x / auto)や、アカウント追加・切り替えをスキップする --no-add、--no-switch などが用意されています。
技術的なポイント
本ツールにおけるスクリプト版の実装は、Androidの動的解析手法を応用した設計になっています。
- Fridaによるプロセスの動的フック: Google Oneアプリの正規プロセスにFridaを用いてアタッチし、実行時にメモリ上でコードを実行します。これにより、バイナリを直接再署名・改変することなく、アプリケーション本来の権限とコンテキストを維持したまま処理を実行しています。
- 動的クラスロード:
DexClassLoaderを活用し、BillingClientと通信するための課金モジュールを動的にメモリ上へロードしています。 - BillingClient APIの直接操作: 決済APIである
queryProductDetailsAsyncを呼び出して対象製品(g1.play.20tbなど)に紐付くオファー情報を取得します。取得したオファーの中からlaunchBillingFlowをメインスレッド上で呼び出し、Playストアの決済UIを展開させています。 - ローカル完結の動作設計: スクリプトはすべて実行端末のローカル環境でのみ動作し、入力された認証情報やカード情報はGoogle公式の通信先以外(作成者や外部サーバーなど)には一切送信されない構成と説明されています。
注意点
本ツールを利用・検証するにあたっては、以下のリスクや制限事項を把握しておく必要があります。
- Google利用規約違反のリスク: 本ツールはクライアント側のオファー取得挙動を突いたPoC(概念実証)であり、Googleの利用規約に抵触してアカウント制限やアカウント停止(BAN)等のペナルティを受ける可能性があります。READMEでも主力のアカウントでは実行しないよう注意喚起がなされています。
- 自動更新による課金リスク: 12ヶ月の試用期間が終了すると、月額料金(READMEの記載例ではUS$99.99/月)の請求が発生します。試用継続を望まない場合は、事前にPlayストアの定期購入管理画面から解約手続きを行う必要があります。
- 成功の保証がない点: アカウントのステータスや地域、過去の利用履歴によっては「無料試用の対象外」と判定され、オファーが適用されないケースがあります。また、試用フローを一度起動すると、完了しなくてもオファー自体が取得できなくなる仕様が存在すると指摘されています。
- 商用・代行利用の禁止: READMEの免責事項において、有償での代行開通、アカウント転売、規模的なバッチ利用などは厳格に禁止されており、あくまでクライアント側のインターフェース解析およびセキュリティ学習目的に限定して公開されています。
- ライセンス: 本リポジトリのソースコードには MIT ライセンスが適用されています。
まとめ
google-ultra は、Google PlayのBillingClientのレスポンスに隠れた試用オファーを取得・検証するPoCプロジェクトです。Fridaを用いた動的フックや DexClassLoader によるクラスロードなど、Androidの高度なリバースエンジニアリング・解析技術が活用されています。利用に伴うアカウントや課金面のリスクを十分に理解した上で、技術研究資料として挙動を確認するのが適切です。





