REST Resource: purchases.productsv2

Risorsa: ProductPurchaseV2

Una risorsa ProductPurchaseV2 indica lo stato dell'acquisto di un prodotto in-app da parte di un utente.

Rappresentazione 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)
}
Campi
productLineItem[]

object (ProductLineItem)

Contiene informazioni a livello di articolo per un ProductPurchaseV2.
kind

string

Questo tipo rappresenta un oggetto ProductPurchaseV2 nel servizio androidpublisher.
purchaseStateContext

object (PurchaseStateContext)

Informazioni sullo stato dell'acquisto.
testPurchaseContext

object (TestPurchaseContext)

Informazioni relative agli acquisti di prova. Questo valore verrà impostato solo per gli acquisti di prova.
orderId

string

L'ID ordine associato all'acquisto del prodotto in-app. Non può essere impostato se non è presente alcun ordine associato all'acquisto.
obfuscatedExternalAccountId

string

Una versione offuscata dell'ID associata in modo univoco all'account dell'utente nella tua app. È presente solo se specificato utilizzando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid al momento dell'acquisto.
obfuscatedExternalProfileId

string

Una versione offuscata dell'ID associata in modo univoco al profilo dell'utente nella tua app. È presente solo se specificato utilizzando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid al momento dell'acquisto.
regionCode

string

Codice della regione di fatturazione ISO 3166-1 alpha-2 dell'utente al momento della concessione del prodotto.
purchaseCompletionTime

string (Timestamp format)

La data e l'ora in cui l'acquisto è andato a buon fine, ovvero quando lo stato PurchaseState è impostato su PURCHASED. Questo campo non sarà presente finché il pagamento non sarà stato completato. Ad esempio, se l'utente ha avviato una transazione in attesa (https://developer.android.com/google/play/billing/integrate#pending), questo campo non verrà compilato finché l'utente non avrà completato correttamente i passaggi necessari per completare la transazione.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
acknowledgementState

enum (AcknowledgementState)

Solo output. Lo stato di conferma dell'acquisto.

PurchaseStateContext

Contesto relativo allo stato dell'acquisto.

Rappresentazione JSON 
{
  "purchaseState": enum (PurchaseState)
}
Campi
purchaseState

enum (PurchaseState)

Solo output. Lo stato dell'acquisto.

PurchaseState

Possibili stati di acquisto.

Enum
PURCHASE_STATE_UNSPECIFIED Stato dell'acquisto non specificato. Questo valore non deve mai essere impostato.
PURCHASED Acquisto completato.
CANCELLED Aquisto annullato.
PENDING L'acquisto è in stato in attesa e non è ancora stato completato. Per ulteriori informazioni sulla gestione degli acquisti in attesa, consulta la pagina https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Contesto relativo a un acquisto di prova.

Rappresentazione JSON 
{
  "fopType": enum (FopType)
}
Campi
fopType

enum (FopType)

Il tipo di fop dell'acquisto di prova.

FopType

Possibili tipi di fop.

Enum
FOP_TYPE_UNSPECIFIED Tipo di FOP non specificato. Questo valore non deve mai essere impostato.
TEST L'acquisto è stato effettuato utilizzando una carta di prova.

ProductLineItem

Contiene informazioni a livello di articolo per un ProductPurchaseV2.

Rappresentazione JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Campi
productId

string

L'ID prodotto acquistato (ad es. "monthly001").
productOfferDetails

object (ProductOfferDetails)

I dettagli dell'offerta per questo articolo.

ProductOfferDetails

Informazioni dettagliate sull'offerta relative a un elemento pubblicitario di acquisto.

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

string

I tag di offerta più recenti associati all'offerta. Sono inclusi i tag ereditati dall'opzione di acquisto.
offerId

string

L'ID offerta. Presente solo per le offerte.
purchaseOptionId

string

L'ID opzione di acquisto.
rentOfferDetails

object (RentOfferDetails)

Fornisci i dettagli delle offerte di noleggio. Questo valore verrà impostato solo per gli elementi pubblicitari di tipo Affitto.
offerToken

string

Il token dell'offerta per transazione utilizzato per creare questo elemento pubblicitario di acquisto.
quantity

integer

La quantità associata all'acquisto del prodotto in-app.
refundableQuantity

integer

La quantità idonea al rimborso, ovvero la quantità che non è stata rimborsata. Il valore riflette i rimborsi parziali e i rimborsi totali basati sulla quantità.
consumptionState

enum (ConsumptionState)

Solo output. Lo stato di consumo dell'acquisto.

RentOfferDetails

Questo tipo non contiene campi.

Informazioni dettagliate sull'offerta relative a un elemento pubblicitario di affitto.

ConsumptionState

Possibili stati di consumo.

Enum
CONSUMPTION_STATE_UNSPECIFIED Stato del consumo non specificato. Questo valore non deve mai essere impostato.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Da consumare.
CONSUMPTION_STATE_CONSUMED Già utilizzato.

AcknowledgementState

Stato di conferma del prodotto a pagamento singolo.

Enum
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Stato di conferma non specificato.
ACKNOWLEDGEMENT_STATE_PENDING L'acquisto non è ancora stato confermato.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED L'acquisto è stato confermato.

Metodi

getproductpurchasev2

 Controlla lo stato di acquisto e consumo di un articolo in-app.