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: afhankelijk van het account apps en games, in-app-aankopen en abonnementen. Zie het als het wat en wanneer, en vaak ook het hoeveel: in de echte export die wij hebben gecontroleerd, had elk item een prijs. Het naastgelegen bestand Order History.json is het bestellingslogboek 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 het type ervan (in de gecontroleerde export een veld
documentType, zoals “In App Item”). - Een aankooptijdstip: wanneer de verkrijging plaatsvond, in UTC in de gecontroleerde export.
- Een prijs: in de gecontroleerde export een veld
invoicePrice, opgemaakte tekst met het valutasymbool (bijvoorbeeld “€5.49”) en zonder aparte valutacode.
Google publiceert geen schema voor Takeout-bestanden, dus niets garandeert een prijs in elk item van elke export. In de echte export die wij hebben gecontroleerd, hadden alle 31 items van Purchase History een prijs, en Order History had bedragen voor zijn 10 bestellingen, waarvan er 9 exact overeenkwamen met een item in Purchase History, tot op de milliseconde en de cent: beide bestanden optellen zou die aankopen dubbel hebben geteld. Ook de ontwikkelaarsdocumentatie van Google over Google Play-gegevens noemt invoicePrice bij de belangrijkste velden van Google Play-aankopen, maar die beschrijft een API voor ontwikkelaars, een ander kanaal dan Takeout, en garandeert niet wat een Takeout-export bevat.
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; vergelijk met Order History voordat je optelt |
Velden die een viewer moet negeren
Order History.json kan velden over betaalmethoden bevatten, en Purchase History.json ook (een veld paymentMethodTitle in de gecontroleerde export). 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 nu op Google Play: kies de ZIP en krijg een archief dat je kunt doorzoeken. Alleen op je apparaat.