Google Play の Purchase History.json を解説
Purchase History.json は Google Play の Takeout エクスポートの中心となるファイルで、何をいつ取得したかを機械で読める一覧として記録します。このページでは、その役割と一般的な構造を、保証に関する重要な注意点とともに説明します。
最初に注意:公開されたスキーマはありません
Google は Play の Takeout ファイルについて、正式なバージョン管理されたスキーマを公開していません。以下は、当方やコミュニティで共有された実際のエクスポートで観察された構造を説明するものです。項目はアカウント、コンテンツの種類、時期によって異なる場合があり、Google が予告なく変更することもあります。ここでいう項目は「通常含まれる」もので、「契約上保証されている」ものではありません。
このファイルの用途
エクスポートの Google Play Store フォルダ内で、Purchase History.json は取得記録を保存します。アカウントにより、アプリやゲーム、アプリ内購入、定期購入などです。つまり何を、いつ取得したかの記録で、多くの場合いくらだったかも含みます。私たちが確認した実際のエクスポートでは、すべての項目に価格がありました。同じフォルダの Order History.json は注文台帳で、金額、通貨、支払い・払い戻し関連の項目を含みます。
一般的な構造
ファイルはレコードの JSON 配列です。各レコードは 1 件の取得を表し、通常は次の情報を持ちます。
- 項目の説明:タイトルと種別(確認したエクスポートでは「In App Item」などの
documentType項目)。 - 購入日時:取得が行われた時刻(確認したエクスポートでは UTC)。
- 価格:確認したエクスポートでは
invoicePrice項目で、通貨記号付きの書式化されたテキスト(例:「€5.49」)。通貨コードは別にありません。
Google は Takeout ファイルのスキーマを公開していないため、すべてのエクスポートのすべての項目に価格があるという保証はありません。私たちが確認した実際のエクスポートでは、Purchase History の 31 項目すべてに価格があり、Order History にも 10 件の注文に金額がありました。そのうち 9 件はミリ秒単位・1 セント単位まで Purchase History の項目と完全に一致していたため、2 つのファイルを合算すると、それらの購入を二重に数えることになります。Google の開発者向け Google Play データのドキュメントも Google Play の購入の主な項目として invoicePrice を挙げていますが、これは開発者向け API の説明で、Takeout とは別の経路であり、Takeout のエクスポート内容を保証するものではありません。
架空の例
以下の断片は説明用に作った架空の例です。実際のユーザーデータではなく、項目名を保証するものでもない簡略図です。実際のエクスポートでは構造の入れ子や名称が異なる場合があります。
[
{
"purchase": {
"document": {
"type": "Android App",
"title": "Example Launcher (fictional)"
},
"purchaseTime": "2019-04-12T14:23:00Z",
"purchaseType": "App"
}
},
{
"purchase": {
"document": {
"type": "In-app item",
"title": "Example Game - Coin Pack (fictional)"
},
"purchaseTime": "2021-11-02T09:05:00Z",
"purchaseType": "In-app purchase"
}
}
]
アプリ、アプリ内購入、定期購入
観察されたエクスポートでは、購入種別の情報によって、多くの人が知りたい次の 3 つの大きなカテゴリを分けられます。
| カテゴリ | レコードが表すもの | 注意点 |
|---|---|---|
| アプリ & ゲーム | アプリまたはゲームを 1 回取得した記録(有料・無料を含む) | 無料アプリも含まれる場合があります。取得 ≠ 支払いです |
| アプリ内購入 | アプリ内で購入した項目 | レコードには購入項目名があり、元のアプリはタイトルから推測が必要な場合があります |
| 定期購入 | 定期購入関連のイベント | 更新と初回の定期購入が別形式で記録される場合があります。合計する前に Order History と照合してください |
ビューアが無視すべき項目
Order History.json には支払い方法に関する項目が含まれる場合があり、Purchase History.json も同様です(確認したエクスポートでは paymentMethodTitle 項目)。適切なビューアやパーサーは処理時にそれらを破棄し、表示も保存もしないべきです。役立つ履歴は「何を、いつ、いくらで」です。カード情報はそこに価値を加えず、リスクだけを増やします。
共有についても同じ考え方です。購入履歴は個人データです。エクスポートはローカルに保管し、アップロードを求めるツールは慎重に扱ってください。
JSON の処理はおまかせ。
App Purchase Vault は Google Play で配信中です。ZIP を選べば検索できるアーカイブに変換。処理は端末内だけで行います。