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 assistir 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 com o 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 formato ISO 3166-1 alfa-2, 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 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.