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.
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:
- Uma descrição do documento: o título do item e o seu tipo (na exportação verificada, um campo
documentTypecomo «In App Item»). - Um carimbo de data/hora da compra: quando a aquisição aconteceu, em UTC na exportação verificada.
- Um preço: na exportação verificada, um campo
invoicePrice, texto formatado com o símbolo da moeda (por exemplo «€5.49»), sem código de moeda separado.
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:
| Categoria | O que um registro representa | Ponto de atenção |
|---|---|---|
| Apps e jogos | Aquisição única de um app ou jogo (pago ou gratuito) | Apps gratuitos também podem aparecer (aquisição ≠ pagamento) |
| Compras no app | Conteúdos comprados dentro de um app | O registro nomeia o item; o app pai pode precisar ser deduzido do título |
| Assinaturas | Eventos ligados a assinaturas | Renovaçõ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.
Do JSON às respostas.
O App Purchase Vault já está no Google Play: escolha o ZIP, ganhe um arquivo pesquisável. Só no aparelho.