REST Resource: purchases.productsv2

Recurso: ProductPurchaseV2

Un recurso ProductPurchaseV2 indica el estado de la compra que hace un usuario de un producto integrado en la aplicación.

Representación JSON 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
Campos
productLineItem[]

object (ProductLineItem)

Contiene información a nivel del artículo para un ProductPurchaseV2.
kind

string

Este tipo representa un objeto ProductPurchaseV2 en el servicio androidpublisher.
purchaseStateContext

object (PurchaseStateContext)

Es la información sobre el estado de la compra.
testPurchaseContext

object (TestPurchaseContext)

Información relacionada con las compras de prueba. Esto solo se establecerá para las compras de prueba.
orderId

string

Es el ID de pedido asociado con la compra del producto integrado en la aplicación. Es posible que no se establezca si no hay ningún pedido asociado con la compra.
obfuscatedExternalAccountId

string

Es una versión ofuscada del ID que está asociado de forma única a la cuenta del usuario en tu app. Solo está presente si se especificó con https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid cuando se realizó la compra.
obfuscatedExternalProfileId

string

Es una versión ofuscada del ID que está asociado de forma única al perfil del usuario en tu app. Solo está presente si se especificó con https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid cuando se realizó la compra.
regionCode

string

Es el código regional de facturación (según ISO 3166-1 Alpha-2) del usuario en el momento en que se otorgó el producto.
purchaseCompletionTime

string (Timestamp format)

Es la hora en la que la compra se realizó correctamente, es decir, cuando el estado PurchaseState cambió a PURCHASED. Este campo no aparecerá hasta que se complete el pago. Por ejemplo, si el usuario inició una transacción pendiente (https://developer.android.com/google/play/billing/integrate#pending), este campo no se propagará hasta que el usuario complete correctamente los pasos necesarios para completar la transacción.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
acknowledgementState

enum (AcknowledgementState)

Solo salida. Es el estado de procesamiento de compra.

PurchaseStateContext

Es el contexto sobre el estado de la compra.

Representación JSON 
{
  "purchaseState": enum (PurchaseState)
}
Campos
purchaseState

enum (PurchaseState)

Solo salida. Es el estado de la compra.

PurchaseState

Estados de compra posibles.

Enumeraciones
PURCHASE_STATE_UNSPECIFIED No se especificó el estado de la compra. Nunca se debe establecer este valor.
PURCHASED La compra se realizó correctamente.
CANCELLED Compra cancelada.
PENDING La compra está pendiente y aún no se completa. Para obtener más información sobre cómo controlar las compras pendientes, consulta https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Es el contexto de una compra de prueba.

Representación JSON 
{
  "fopType": enum (FopType)
}
Campos
fopType

enum (FopType)

Es el tipo de fop de la compra de prueba.

FopType

Posibles tipos de fop.

Enumeraciones
FOP_TYPE_UNSPECIFIED No se especificó el tipo de FOP. Nunca se debe establecer este valor.
TEST La compra se realizó con una tarjeta de prueba.

ProductLineItem

Contiene información a nivel del artículo para un ProductPurchaseV2.

Representación JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Campos
productId

string

Es el ID del producto comprado (por ejemplo, "monthly001").
productOfferDetails

object (ProductOfferDetails)

Son los detalles de la oferta para este elemento.

ProductOfferDetails

Es información detallada de una oferta relacionada con un concepto de la compra.

Representación JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
Campos
offerTags[]

string

Son las etiquetas más recientes asociadas con la oferta. Incluye etiquetas heredadas de la opción de compra.
offerId

string

Es el ID de la oferta. Solo está presente para las ofertas.
purchaseOptionId

string

Es el ID de la opción de compra.
rentOfferDetails

object (RentOfferDetails)

Detalles de las ofertas de alquiler Esto solo se establecerá para las líneas de pedido de alquiler.
offerToken

string

Es el token de oferta por transacción que se usó para realizar esta línea de pedido de compra.
quantity

integer

Es la cantidad asociada con la compra del producto integrado en la aplicación.
refundableQuantity

integer

Es la cantidad apta para reembolso, es decir, la cantidad que no se reembolsó. El valor refleja reembolsos parciales basados en cantidades y reembolsos totales.
consumptionState

enum (ConsumptionState)

Solo salida. Es el estado de consumo de la compra.

RentOfferDetails

Este tipo no tiene campos.

Es información detallada de una oferta relacionada con un concepto de alquiler.

ConsumptionState

Estados de consumo posibles.

Enumeraciones
CONSUMPTION_STATE_UNSPECIFIED No se especificó el estado de consumo. Nunca se debe establecer este valor.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Aún no se consume.
CONSUMPTION_STATE_CONSUMED Ya se consumió.

AcknowledgementState

Es el estado de procesamiento de compra del producto único.

Enumeraciones
ACKNOWLEDGEMENT_STATE_UNSPECIFIED No se especificó el estado de confirmación.
ACKNOWLEDGEMENT_STATE_PENDING Aún no se reconoce la compra.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Se confirmó la compra.

Métodos

getproductpurchasev2

 Verifica el estado del consumo y la compra de un elemento integrado en la app.