Google Play Purchase History.json uitgelegd
Purchase History.json is het hart van een Google Play Takeout-export: de machineleesbare lijst van wat je hebt verkregen en wanneer. Deze pagina legt de rol en algemene structuur uit, met een belangrijke kanttekening over garanties.
Eerst de kanttekening: geen gepubliceerd schema
Google publiceert geen formeel, van versies voorzien schema voor de Play Takeout-bestanden. Alles hieronder beschrijft de structuur zoals die in echte exports is waargenomen, in die van ons en die door de community zijn gedocumenteerd. Velden kunnen verschillen tussen accounts, contenttypen en perioden en Google kan ze zonder aankondiging wijzigen. Elke uitspraak hier betekent “doorgaans aanwezig”, nooit “contractueel gegarandeerd”.
Waar het bestand voor dient
In de map Google Play Store van je export registreert Purchase History.json verkrijgingen: apps en games die je kreeg, in-app-aankopen die je deed en abonnementen die je startte. Zie het als het wat en wanneer. Het hoeveel staat doorgaans in het naastgelegen bestand Order History.json, het transactielogboek met bedragen, valuta en velden rond betaling en terugbetaling.
Algemene structuur
Het bestand is een JSON-array met records. Elk record beschrijft één verkrijging en bevat doorgaans:
- Een documentbeschrijving: de titel van het item en vaak een type dat een Android-app onderscheidt van andere content.
- Een aankooptijdstip: wanneer de verkrijging plaatsvond.
- Een aankooptype: om bijvoorbeeld een app-aankoop te onderscheiden van een in-app-aankoop of abonnement.
Prijs- en betaalgegevens staan meestal niet in dit bestand; dat is de taak van Order History. Door beide te koppelen krijg je “naam + datum + prijs” voor een aankoop.
Een fictief voorbeeld
Het fragment hieronder is verzonnen ter illustratie. Het zijn geen echte gebruikersgegevens en het is een vereenvoudigde schets, geen belofte over veldnamen. Een echte export kan zaken anders nesten of benoemen:
[
{
"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"
}
}
]
Apps, IAP, abonnementen
In waargenomen exports kun je met de informatie over het aankooptype de drie grote categorieën onderscheiden waar mensen om geven:
| Categorie | Wat een record voorstelt | Let op |
|---|---|---|
| Apps & games | Eenmalige verkrijging van een app of game (betaald of gratis) | Gratis apps kunnen ook verschijnen: verkrijging ≠ betaling |
| In-app-aankopen | Items die in een app zijn gekocht | Het record noemt het item; de bijbehorende app moet soms uit de titel worden afgeleid |
| Abonnementen | Gebeurtenissen rond abonnementen | Verlengingen en het eerste abonnement kunnen anders worden geregistreerd; controleer Order History voor bedragen |
Velden die een viewer moet negeren
Order History.json kan velden over betaalmethoden bevatten. Een nette viewer of parser hoort die tijdens het verwerken te verwijderen: nooit tonen, nooit opslaan. De nuttige geschiedenis is “wat, wanneer, hoeveel”. Kaartgegevens voegen daar niets aan toe, alleen risico.
Dezelfde discipline geldt voor delen: aankoopgeschiedenis is persoonlijke data. Houd exports lokaal en wees wantrouwig tegenover tools die ze willen uploaden.
Wij regelen de JSON.
App Purchase Vault is in Android-bèta: kies de ZIP en krijg een archief dat je kunt doorzoeken. Alleen op je apparaat.