App Purchase Vault
Takeout · Técnico

Purchase History.json de Google Play explicado

Purchase History.json es el corazón de una exportación Takeout de Google Play: la lista legible por máquina de lo que adquiriste, y cuándo. Esta página explica su papel y su estructura general, con una advertencia importante sobre las garantías.

Actualizado: octubre de 2026 · Por el proyecto App Purchase Vault · 6 min de lectura

Primero, la advertencia: no hay esquema publicado

Google no publica un esquema formal y versionado para los archivos Takeout de Play. Todo lo que sigue describe la estructura tal como se ha observado en exportaciones reales, las nuestras y las documentadas por la comunidad. Los campos pueden diferir según las cuentas, los tipos de contenido y los periodos, y Google puede modificarlos sin previo aviso. Toda afirmación aquí es «normalmente presente», nunca «contractualmente garantizada».

Para qué sirve el archivo

En la carpeta Google Play Store de tu exportación, Purchase History.json registra las adquisiciones: según la cuenta, apps y juegos, compras integradas, suscripciones. Míralo como el qué y cuándo, y a menudo también el cuánto: en la exportación real que verificamos, cada entrada llevaba un precio. El archivo vecino, Order History.json, lleva el registro de pedidos: importes, divisa, campos ligados al pago y a los reembolsos.

Estructura general

El archivo es un array JSON de registros. Cada registro describe una adquisición y suele llevar:

Google no publica ningún esquema de los archivos de Takeout, así que nada garantiza un precio en cada entrada de cada exportación. En la exportación real que verificamos, las 31 entradas de Purchase History llevaban precio, y Order History llevaba importes en sus 10 pedidos, 9 de los cuales coincidían exactamente con una entrada de Purchase History, al milisegundo y al céntimo: sumar ambos archivos habría contado esas compras dos veces. La documentación para desarrolladores de Google sobre los datos de Google Play también incluye invoicePrice entre los campos clave de las compras de Google Play, pero describe una API para desarrolladores, un canal distinto de Takeout, y no garantiza lo que contiene una exportación de Takeout.

Un ejemplo ficticio

El extracto siguiente está inventado a modo de ilustración. No son datos reales, y es un esbozo simplificado, no una promesa sobre los nombres de los campos. Una exportación real puede anidar o nombrar las cosas de otra manera:

[
{
"purchase": {
"document": {
"type": "Android App",
"title": "Example Launcher (ficticio)"
},
"purchaseTime": "2019-04-12T14:23:00Z",
"purchaseType": "App"
}
},
{
"purchase": {
"document": {
"type": "In-app item",
"title": "Example Game - Coin Pack (ficticio)"
},
"purchaseTime": "2021-11-02T09:05:00Z",
"purchaseType": "In-app purchase"
}
}
]

Apps, compras integradas, suscripciones

En las exportaciones observadas, la información de tipo de compra es lo que permite separar las tres grandes categorías que interesan a los usuarios:

CategoríaLo que representa un registroPunto de atención
Apps y juegosAdquisición única de una app o un juego (de pago o gratuita)Las apps gratuitas también pueden aparecer: adquisición no significa pago
Compras integradasContenidos comprados dentro de una appEl registro nombra el artículo; la app madre puede tener que deducirse del título
SuscripcionesEventos ligados a suscripcionesRenovaciones y suscripción inicial pueden registrarse de forma distinta; compáralo con Order History antes de sumar

Los campos que un lector debería ignorar

Order History.json puede contener campos ligados al método de pago, y Purchase History.json también (un campo paymentMethodTitle en la exportación verificada). Un lector o analizador bien diseñado debería descartarlos durante el análisis, sin mostrarlos ni almacenarlos nunca. El historial útil es «qué, cuándo, cuánto». Los datos de tarjeta no aportan nada a eso, y sí todo el riesgo.

La misma disciplina se aplica al compartir: un historial de compras es un dato personal. Guarda tus exportaciones en local, y mira con recelo cualquier herramienta que quiera enviarlas en línea.

Cómo lo usamosApp Purchase Vault analiza exactamente estos archivos en tu teléfono: Purchase History para los artículos, las fechas y los precios; Order History para los pedidos que no figuran en él, emparejados de forma exacta para no contar nunca dos veces la misma compra. Los campos de pago sensibles se descartan en el momento del análisis. La tolerancia a las variaciones de esquema descrita arriba es un requisito de diseño, no una idea tardía.

Olvídate del JSON.

App Purchase Vault ya está en Google Play: eliges el ZIP, obtienes un archivo consultable. Solo en el dispositivo.

Descargar en Google Play