REST Resource: purchases.products

Recurso: ProductPurchase

O recurso ProductPurchase indica o status da compra de um produto no aplicativo de 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 (1o de janeiro de 1970).

purchaseState

integer

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

consumptionState

integer

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

developerPayload

string

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

orderId

string

O código do pedido associado à compra do produto no aplicativo.

purchaseType

integer

O tipo de compra do produto no app. Esse campo só será definido se a compra não tiver sido feita usando o fluxo padrão de faturamento no app. Os valores possíveis são: 0. Teste (por exemplo, comprado de uma conta de teste de licença) 1. Promoção (ou seja, comprada usando um código promocional). Isso não inclui compras do Play Points. 2. Premiado (por exemplo, assistir um anúncio em vídeo em vez de pagar)

acknowledgementState

integer

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

purchaseToken

string

O token de compra gerado para identificar essa compra. Pode não estar presente.

productId

string

A SKU do produto no aplicativo. Pode não estar presente.

quantity

integer

A quantidade associada à compra do produto no aplicativo. Se não estiver presente, a quantidade será 1.

obfuscatedExternalAccountId

string

Uma versão ofuscada do ID exclusivamente associada à conta do usuário no app. Só estará presente se especificado usando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid quando a compra for feita.

obfuscatedExternalProfileId

string

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

regionCode

string

Código de região de faturamento ISO 3166-1 alfa-2 do usuário no momento em que o produto foi concedido.

refundableQuantity

integer

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

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.