Purchase History.json de Google Play expliqué
Purchase History.json est le cœur d'un export Takeout Google Play : la liste lisible par machine de ce que vous avez acquis, et quand. Cette page explique son rôle et sa structure générale, avec une mise en garde importante sur les garanties.
D'abord, la mise en garde : aucun schéma publié
Google ne publie pas de schéma formel et versionné pour les fichiers Takeout de Play. Tout ce qui suit décrit la structure telle qu'observée dans des exports réels, les nôtres et ceux documentés par la communauté. Les champs peuvent différer selon les comptes, les types de contenu et les périodes, et Google peut les modifier sans préavis. Toute affirmation ici est « généralement présent », jamais « contractuellement garanti ».
À quoi sert le fichier
Dans le dossier Google Play Store de votre export, Purchase History.json consigne les acquisitions : selon le compte, applis et jeux, achats intégrés, abonnements. Voyez-le comme le quoi et quand, et souvent aussi le combien : dans l'export réel que nous avons vérifié, chaque entrée portait un prix. Le fichier voisin, Order History.json, tient le registre des commandes : montants, devise, champs liés au paiement et aux remboursements.
Structure générale
Le fichier est un tableau JSON d'enregistrements. Chaque enregistrement décrit une acquisition et porte généralement :
- Une description du document : le titre de l'article et son type (voir ci-dessous).
- Un horodatage d'achat : quand l'acquisition a eu lieu, en UTC dans l'export vérifié.
- Un prix : dans l'export vérifié, un champ
invoicePrice, sous forme de texte formaté avec le symbole monétaire (par exemple « €5.49 »), sans code de devise séparé. - Un type : dans l'export vérifié, c'est le champ
documentTypede la description (par exemple « In App Item ») qui distingue un achat intégré d'une appli ou d'un autre contenu ; nous n'y avons pas vu de champ de type d'achat séparé.
Google ne publiant aucun schéma des fichiers Takeout, rien ne garantit qu'un prix figure dans chaque entrée de chaque export. Ce que nous savons :
- Dans l'export réel vérifié, les 31 entrées de Purchase History portaient toutes un prix. Order History en portait aussi pour ses 10 commandes, dont 9 correspondaient exactement à une entrée de Purchase History, à la milliseconde et au centime près. Additionner les deux fichiers aurait donc compté ces achats deux fois.
- Côté développeurs, la documentation de Google destinée aux développeurs sur les données Google Play liste aussi
invoicePriceparmi les champs clés des achats Google Play. Mais elle décrit une API pour développeurs, un autre canal que Takeout, et Google précise que tous les services ou actions ne produisent pas chaque champ : elle ne garantit pas le contenu d'un export Takeout.
Pour un achat précis, cherchez-le dans les deux fichiers ; pour un total, ne comptez qu'une fois une commande qui correspond à un achat. Si un fichier manque ou semble incomplet, voyez que faire quand l'historique d'achats Takeout est vide ou incomplet.
Un exemple fictif
Les valeurs de l'extrait ci-dessous sont inventées pour l'illustration ; la structure reprend celle de l'export réel vérifié, simplifiée (certains champs, comme le pays, la langue ou le moyen de paiement, sont omis). Un autre export peut imbriquer ou nommer les choses différemment :
[
{
"purchaseHistory": {
"doc": {
"documentType": "In App Item",
"title": "Example Game - Coin Pack (fictional)"
},
"invoicePrice": "€4.99",
"purchaseTime": "2021-11-02T09:05:00.000Z"
}
},
{
"purchaseHistory": {
"doc": {
"documentType": "In App Item",
"title": "Example Game - Season Pass (fictional)"
},
"invoicePrice": "€9.99",
"purchaseTime": "2022-03-14T18:40:12.000Z"
}
}
]
Applis, achats intégrés, abonnements
Le type porté par chaque entrée est ce qui permet de séparer les trois grandes catégories qui intéressent les utilisateurs. Dans l'export vérifié, Purchase History ne contenait que des achats intégrés ; le compte n'avait peut-être jamais acheté d'appli payante, donc on ne peut pas en conclure où une telle appli apparaîtrait :
| Catégorie | Ce qu'un enregistrement représente | Point de vigilance |
|---|---|---|
| Applis & jeux | Acquisition unique d'une appli ou d'un jeu (payant ou gratuit) | Les applis gratuites peuvent apparaître aussi : acquisition ≠ paiement |
| Achats intégrés | Contenus achetés à l'intérieur d'une appli | L'enregistrement nomme l'article ; l'appli parente peut devoir être déduite du titre |
| Abonnements | Événements liés aux abonnements | Renouvellements et souscription initiale peuvent être consignés différemment ; comparez avec Order History avant de totaliser |
Les champs qu'un lecteur devrait ignorer
Order History.json peut contenir des champs liés au moyen de paiement, et Purchase History.json aussi (un champ paymentMethodTitle dans l'export vérifié). Un lecteur ou un analyseur bien conçu devrait les écarter pendant l'analyse : ne jamais les afficher, ne jamais les stocker. L'historique utile, c'est « quoi, quand, combien ». Les données de carte n'ajoutent rien à cela, seulement du risque.
La même discipline s'applique au partage : un historique d'achats est une donnée personnelle. Gardez vos exports en local, et considérez avec méfiance tout outil qui veut les envoyer en ligne.
Le JSON, on s'en charge.
App Purchase Vault est disponible sur Google Play : choisissez le ZIP, obtenez une archive dans laquelle chercher. Uniquement sur l'appareil.