App Purchase Vault
Takeout · Technisch

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.

Bijgewerkt: oktober 2026 · Door het App Purchase Vault-project · 6 min leestijd

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:

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:

CategorieWat een record voorsteltLet op
Apps & gamesEenmalige verkrijging van een app of game (betaald of gratis)Gratis apps kunnen ook verschijnen: verkrijging ≠ betaling
In-app-aankopenItems die in een app zijn gekochtHet record noemt het item; de bijbehorende app moet soms uit de titel worden afgeleid
AbonnementenGebeurtenissen rond abonnementenVerlengingen 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.

Hoe wij dit gebruikenApp Purchase Vault verwerkt precies deze bestanden op je telefoon: Purchase History voor items, datums en prijzen; Order History voor bestellingen die daar niet in staan, exact gekoppeld zodat dezelfde aankoop nooit dubbel wordt geteld. Gevoelige betaalvelden worden tijdens het verwerken verwijderd. De hierboven beschreven tolerantie voor schemavariatie is een ontwerpeis, geen bijzaak.

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.

Download op Google Play