REST Resource: purchases.products

Recurso: ProductPurchase

Um recurso ProductPurchase indica o status da compra de um produto no app feita por um usuário.

Representação JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
Campos
kind

string

Esse tipo representa um objeto inappPurchase no serviço androidpublisher.
purchaseTimeMillis

string (int64 format)

A hora em que o produto foi comprado, em milissegundos desde a época (1º de janeiro de 1970).
purchaseState

integer

O estado de compra do pedido. Os valores possíveis são: 0. Comprado: 1. Cancelado: 2. Pendente
consumptionState

integer

O estado de consumo do produto no app. Os valores possíveis são: 0. Ainda vai ser consumido: 1. Consumiu
developerPayload

string

Uma string especificada pelo desenvolvedor que contém informações complementares sobre um pedido.
orderId

string

O ID do pedido associado à compra do produto no app.
purchaseType

integer

O tipo de compra do produto no app. Este campo só é definido se a compra não foi feita usando o fluxo de faturamento no app padrão. Os valores possíveis são: 0. Teste (compra feita com uma conta de teste de licença): 1. Promoção (compra feita com um código promocional). Não inclui compras do Play Points. 2. Prêmio (adquirido ao ver um anúncio em vídeo, e não pagando).
acknowledgementState

integer

O estado de confirmação do produto no app. Os valores possíveis são: 0. Ainda não foi confirmado; 1. Reconhecido
purchaseToken

string

O token gerado para identificar esta compra. Pode não estar presente.
productId

string

O SKU do produto no app. Pode não estar presente.
quantity

integer

A quantidade associada à compra do produto no app. Caso não esteja presente, a quantidade é 1.
obfuscatedExternalAccountId

string

Uma versão ofuscada do ID que é exclusivamente associado à conta do usuário no seu app. Presente apenas se especificada usando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid quando a compra foi feita.
obfuscatedExternalProfileId

string

Uma versão ofuscada do ID que é exclusivamente associado ao perfil do usuário no seu app. Presente apenas se especificada usando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid quando a compra foi feita.
regionCode

string

Código regional de faturamento do usuário no momento em que o produto foi concedido, no formato ISO 3166-1 alpha-2.
refundableQuantity

integer

A quantidade qualificada para reembolso, ou seja, a quantidade que não foi reembolsada. O valor reflete reembolsos parciais e totais com base em quantidade.

Métodos

acknowledge

 Confirma a compra de um item no app.

consume

 Consome a compra de um item no app.

get

 Verifica o status de compra e consumo de um item no app.

Códigos de erro

As operações desse recurso retornam os seguintes códigos de erro HTTP:

Código do erro Motivo Descrição Resolução