App Purchase Vault
Takeout · Techniczne

Wyjaśnienie pliku Google Play Purchase History.json

Purchase History.json jest sercem eksportu Google Play z Takeout: to odczytywalna maszynowo lista tego, co pozyskałeś i kiedy. Ta strona wyjaśnia jego rolę i ogólną strukturę, z ważnym zastrzeżeniem dotyczącym gwarancji.

Zaktualizowano: październik 2026 · Projekt App Purchase Vault · 6 min czytania

Najpierw zastrzeżenie: brak opublikowanego schematu

Google nie publikuje formalnego, wersjonowanego schematu plików Play z Takeout. Wszystko poniżej opisuje strukturę zaobserwowaną w rzeczywistych eksportach — naszych i dokumentowanych przez społeczność. Pola mogą różnić się między kontami, typami treści i okresami, a Google może zmienić je bez ostrzeżenia. Każde stwierdzenie tutaj oznacza „zwykle występuje”, nigdy „jest gwarantowane umową”.

Do czego służy ten plik

W folderze Google Play Store eksportu plik Purchase History.json zapisuje pozyskania: zależnie od konta aplikacje i gry, zakupy w aplikacjach, subskrypcje. To przede wszystkim co i kiedy, a często także ile: w sprawdzonym przez nas prawdziwym eksporcie każdy wpis zawierał cenę. Sąsiedni plik Order History.json pełni rolę rejestru zamówień: kwoty, waluta oraz pola związane z płatnościami i zwrotami.

Ogólna struktura

Plik jest tablicą JSON z rekordami. Każdy rekord opisuje jedno pozyskanie i zwykle zawiera:

Google nie publikuje schematu plików Takeout, więc nic nie gwarantuje ceny w każdym wpisie każdego eksportu. W sprawdzonym przez nas prawdziwym eksporcie wszystkie 31 wpisów Purchase History zawierało cenę, a Order History zawierał kwoty dla swoich 10 zamówień, z których 9 dokładnie odpowiadało wpisom w Purchase History, co do milisekundy i grosza: zsumowanie obu plików policzyłoby te zakupy dwukrotnie. Dokumentacja Google dla deweloperów dotycząca danych Google Play również wymienia invoicePrice wśród kluczowych pól zakupów w Google Play, ale opisuje API dla deweloperów, czyli inny kanał niż Takeout, i nie gwarantuje zawartości eksportu Takeout.

Fikcyjny przykład

Poniższy fragment został wymyślony wyłącznie jako ilustracja. Nie zawiera prawdziwych danych użytkownika i jest uproszczonym szkicem, a nie obietnicą nazw pól. Rzeczywisty eksport może zagnieżdżać lub nazywać dane inaczej:

[
  {
    "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"
    }
  }
]

Aplikacje, zakupy w aplikacji, subskrypcje

W obserwowanych eksportach informacja o typie zakupu pozwala rozdzielić trzy główne kategorie, które interesują większość osób:

KategoriaCo reprezentuje rekordNa co uważać
Aplikacje i gryJednorazowe pozyskanie aplikacji lub gry (płatnej albo bezpłatnej)Mogą pojawić się też darmowe aplikacje: pozyskanie ≠ płatność
Zakupy w aplikacjiPozycje kupione wewnątrz aplikacjiRekord podaje nazwę pozycji; aplikację nadrzędną czasem trzeba wywnioskować z tytułu
SubskrypcjeZdarzenia związane z subskrypcjąOdnowienia i pierwsza subskrypcja mogą być zapisane inaczej; przed sumowaniem porównaj z Order History

Pola, które przeglądarka powinna ignorować

Order History.json może zawierać pola związane z metodą płatności, podobnie jak Purchase History.json (pole paymentMethodTitle w sprawdzonym eksporcie). Dobrze zaprojektowana przeglądarka lub parser powinien odrzucać je podczas przetwarzania: nigdy ich nie wyświetlać ani nie zapisywać. Przydatna historia to „co, kiedy, za ile”. Dane karty nic do tego nie wnoszą, a tylko zwiększają ryzyko.

Ta sama zasada dotyczy udostępniania: historia zakupów to dane osobowe. Trzymaj eksporty lokalnie i podchodź ostrożnie do każdego narzędzia, które chce je przesyłać.

Jak z tego korzystamyApp Purchase Vault przetwarza właśnie te pliki na Twoim telefonie: Purchase History dla pozycji, dat i cen; Order History dla zamówień, których tam nie ma, dopasowywanych dokładnie, aby ten sam zakup nigdy nie został policzony dwa razy. Wrażliwe pola płatnicze są odrzucane podczas przetwarzania. Odporność na różnice w schemacie opisana wyżej jest założeniem projektowym, a nie dodatkiem na później.

My zajmiemy się JSON-em.

App Purchase Vault jest już w Google Play: wybierz ZIP i otrzymaj archiwum z wyszukiwaniem. Tylko na urządzeniu.

Pobierz z Google Play