Purchase History.json von Google Play erklärt
Purchase History.json ist das Herzstück eines Takeout-Exports von Google Play: die maschinenlesbare Liste dessen, was du erworben hast und wann. Diese Seite erklärt ihre Rolle und ihre allgemeine Struktur, mit einem wichtigen Vorbehalt zu den Garantien.
Zuerst der Vorbehalt: kein veröffentlichtes Schema
Google veröffentlicht kein formales, versioniertes Schema für die Takeout-Dateien von Play. Alles Folgende beschreibt die Struktur so, wie sie in echten Exporten beobachtet wurde, in unseren und in den von der Community dokumentierten. Die Felder können je nach Konto, Inhaltstyp und Zeitraum abweichen, und Google kann sie ohne Vorankündigung ändern. Jede Aussage hier ist „in der Regel vorhanden“, niemals „vertraglich garantiert“.
Wozu die Datei dient
Im Ordner Google Play Store deines Exports hält Purchase History.json die Erwerbe fest: je nach Konto Apps und Spiele, In-App-Käufe, Abos. Versteh sie als das Was und Wann und oft auch das Wieviel: Im echten Export, den wir geprüft haben, trug jeder Eintrag einen Preis. Die Nachbardatei Order History.json führt das Bestellregister: Beträge, Währung, Felder zu Zahlung und Rückerstattungen.
Allgemeine Struktur
Die Datei ist ein JSON-Array von Datensätzen. Jeder Datensatz beschreibt einen Erwerb und trägt in der Regel:
- Eine Dokumentbeschreibung: den Titel des Artikels und seinen Typ (im geprüften Export ein Feld
documentType, etwa „In App Item“). - Einen Kauf-Zeitstempel: wann der Erwerb stattfand, im geprüften Export in UTC.
- Einen Preis: im geprüften Export ein Feld
invoicePrice, formatierter Text mit Währungssymbol (zum Beispiel „€5.49“) ohne separaten Währungscode.
Google veröffentlicht kein Schema für Takeout-Dateien, daher garantiert nichts einen Preis in jedem Eintrag jedes Exports. Im echten Export, den wir geprüft haben, trugen alle 31 Einträge von Purchase History einen Preis, und Order History enthielt Beträge für seine 10 Bestellungen, von denen 9 exakt einem Eintrag in Purchase History entsprachen, auf die Millisekunde und den Cent genau: Beide Dateien zu addieren hätte diese Käufe doppelt gezählt. Auch die Entwicklerdokumentation von Google zu Google-Play-Daten führt invoicePrice unter den wichtigsten Feldern von Google-Play-Käufen, beschreibt aber eine API für Entwickler, also einen anderen Kanal als Takeout, und garantiert nicht, was ein Takeout-Export enthält.
Ein fiktives Beispiel
Der folgende Auszug ist zur Veranschaulichung erfunden. Es sind keine echten Daten, und es ist eine vereinfachte Skizze, kein Versprechen auf Feldnamen. Ein echter Export kann Dinge anders verschachteln oder benennen:
[
{
"purchase": {
"document": {
"type": "Android App",
"title": "Example Launcher (fiktiv)"
},
"purchaseTime": "2019-04-12T14:23:00Z",
"purchaseType": "App"
}
},
{
"purchase": {
"document": {
"type": "In-app item",
"title": "Example Game - Coin Pack (fiktiv)"
},
"purchaseTime": "2021-11-02T09:05:00Z",
"purchaseType": "In-app purchase"
}
}
]
Apps, In-App-Käufe, Abos
In den beobachteten Exporten ist die Kauftyp-Information das, was die drei großen Kategorien trennt, die Nutzer interessieren:
| Kategorie | Was ein Datensatz darstellt | Stolperstelle |
|---|---|---|
| Apps & Spiele | Einmaliger Erwerb einer App oder eines Spiels (kostenpflichtig oder kostenlos) | Kostenlose Apps können ebenfalls erscheinen (Erwerb ≠ Zahlung) |
| In-App-Käufe | Inhalte, die innerhalb einer App gekauft wurden | Der Datensatz nennt den Artikel; die übergeordnete App muss eventuell aus dem Titel abgeleitet werden |
| Abos | Ereignisse mit Abo-Bezug | Verlängerungen und Erstabschluss können unterschiedlich erfasst werden; vor dem Summieren mit Order History abgleichen |
Die Felder, die ein Leser ignorieren sollte
Order History.json kann Felder zur Zahlungsmethode enthalten, Purchase History.json ebenso (ein Feld paymentMethodTitle im geprüften Export). Ein gut gebauter Leser oder Parser sollte sie bei der Analyse ausschließen: sie nie anzeigen, nie speichern. Der nützliche Verlauf ist „was, wann, wie viel“. Kartendaten tragen dazu nichts bei und bergen das ganze Risiko.
Dieselbe Disziplin gilt fürs Teilen: Ein Kaufverlauf ist eine persönliche Information. Behalte deine Exporte lokal, und betrachte jedes Werkzeug misstrauisch, das sie online schicken will.
Aus JSON werden Antworten.
App Purchase Vault ist jetzt bei Google Play: Wähle die ZIP, erhalte ein durchsuchbares Archiv. Nur auf dem Gerät.