App Purchase Vault
Takeout · Técnico

Purchase History.json do Google Play explicado

O Purchase History.json é o coração de uma exportação do Takeout do Google Play: a lista legível por máquina do que você adquiriu, e quando. Esta página explica seu papel e sua estrutura geral, com uma ressalva importante sobre garantias.

Atualizado: outubro de 2026 · Pelo projeto App Purchase Vault · 6 min de leitura

Primeiro, a ressalva: não há esquema publicado

O Google não publica um esquema formal e versionado para os arquivos do Takeout da Play. Tudo o que segue descreve a estrutura conforme observada em exportações reais, as nossas e as documentadas pela comunidade. Os campos podem diferir conforme as contas, os tipos de conteúdo e os períodos, e o Google pode alterá-los sem aviso. Toda afirmação aqui é «geralmente presente», nunca «contratualmente garantida».

Para que serve o arquivo

Na pasta Google Play Store da sua exportação, o Purchase History.json registra as aquisições: conforme a conta, apps e jogos, compras no app, assinaturas. Veja-o como o o quê e quando e, muitas vezes, também o quanto: na exportação real que verificamos, cada entrada trazia um preço. O arquivo vizinho, Order History.json, mantém o registro dos pedidos: valores, moeda, campos ligados ao pagamento e a reembolsos.

Estrutura geral

O arquivo é um array JSON de registros. Cada registro descreve uma aquisição e costuma trazer:

O Google não publica nenhum esquema dos arquivos do Takeout, então nada garante um preço em cada entrada de cada exportação. Na exportação real que verificamos, as 31 entradas do Purchase History traziam preço, e o Order History trazia valores nos seus 10 pedidos, 9 dos quais correspondiam exatamente a uma entrada do Purchase History, no milissegundo e no centavo: somar os dois arquivos teria contado essas compras duas vezes. A documentação do Google para desenvolvedores sobre os dados do Google Play também lista invoicePrice entre os campos principais das compras do Google Play, mas descreve uma API para desenvolvedores, um canal diferente do Takeout, e não garante o que uma exportação do Takeout contém.

Um exemplo fictício

O trecho abaixo foi inventado para ilustrar. Não são dados reais, e é um esboço simplificado, não uma promessa sobre nomes de campos. Uma exportação real pode aninhar ou nomear as coisas de outro jeito:

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

Apps, compras no app, assinaturas

Nas exportações observadas, a informação de tipo de compra é o que permite separar as três grandes categorias que interessam aos usuários:

CategoriaO que um registro representaPonto de atenção
Apps e jogosAquisição única de um app ou jogo (pago ou gratuito)Apps gratuitos também podem aparecer (aquisição ≠ pagamento)
Compras no appConteúdos comprados dentro de um appO registro nomeia o item; o app pai pode precisar ser deduzido do título
AssinaturasEventos ligados a assinaturasRenovações e assinatura inicial podem ser registradas de forma diferente; compare com o Order History antes de somar

Os campos que um leitor deveria ignorar

O Order History.json pode conter campos ligados ao meio de pagamento, e o Purchase History.json também (um campo paymentMethodTitle na exportação verificada). Um leitor ou analisador bem construído deveria descartá-los durante a análise: nunca exibi-los, nunca armazená-los. O histórico útil é «o quê, quando, quanto». Dados de cartão não acrescentam nada a isso, e sim todo o risco.

A mesma disciplina vale para o compartilhamento: um histórico de compras é um dado pessoal. Guarde suas exportações localmente e desconfie de qualquer ferramenta que queira enviá-las online.

Como nós os usamosO App Purchase Vault analisa exatamente esses arquivos no seu telefone: Purchase History para os itens, as datas e os preços; Order History para os pedidos que não estão nele, associados de forma exata para que a mesma compra nunca seja contada duas vezes. Os campos sensíveis de pagamento são descartados no momento da análise. A tolerância às variações de esquema descrita acima é um requisito de design, não uma reflexão tardia.

Do JSON às respostas.

O App Purchase Vault já está no Google Play: escolha o ZIP, ganhe um arquivo pesquisável. Só no aparelho.

Baixar no Google Play