REST Resource: externaltransactions

Risorsa: ExternalTransaction

I dettagli di una transazione esterna.

Rappresentazione JSON 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
Campi
packageName

string

Solo output. Il nome della risorsa della transazione esterna. Il nome del pacchetto dell'applicazione in cui sono stati venduti i prodotti in-app (ad es. "com.some.app").
externalTransactionId

string

Solo output. L'ID di questa transazione. Tutti gli ID transazione con lo stesso nome del pacchetto devono essere univoci. Impostato durante la creazione della transazione esterna.
originalPreTaxAmount

object (Price)

Obbligatorio. L'importo originale della transazione prima delle imposte. Si tratta dell'importo al lordo delle imposte originariamente comunicato a Google prima dell'applicazione di eventuali rimborsi.
originalTaxAmount

object (Price)

Obbligatorio. L'importo originale dell'imposta. Si tratta dell'importo dell'imposta originariamente comunicato a Google prima dell'applicazione di eventuali rimborsi.
currentPreTaxAmount

object (Price)

Solo output. L'importo corrente della transazione al netto delle imposte. Rappresenta l'importo corrente al netto delle imposte, inclusi eventuali rimborsi che potrebbero essere stati applicati a questa transazione.
currentTaxAmount

object (Price)

Solo output. L'importo attuale dell'imposta. Rappresenta l'importo attuale dell'imposta, inclusi eventuali rimborsi che potrebbero essere stati applicati a questa transazione.
testPurchase

object (ExternalTransactionTestPurchase)

Solo output. Se impostato, indica che questa transazione è un acquisto di prova. Google non addebita alcun costo per una transazione di prova.
transactionTime

string (Timestamp format)

Obbligatorio. L'ora in cui è stata completata la transazione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata questa transazione. Si tratta del momento in cui Google è stata informata della transazione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

Solo output. Lo stato attuale della transazione.
userTaxAddress

object (ExternalTransactionAddress)

Obbligatorio. Indirizzo dell'utente per il calcolo delle imposte.
transactionProgramCode

integer

Facoltativo. Il codice del programma di transazioni, utilizzato per determinare la commissione di servizio per le app idonee che partecipano ai programmi partner. Gli sviluppatori che partecipano al Programma Esperienza multimediale Play (https://play.google.com/console/about/programs/mediaprogram/) devono fornire il codice del programma quando segnalano transazioni di fatturazione alternativa. Se sei uno sviluppatore idoneo, contatta il tuo BDM per ulteriori informazioni su come impostare questo campo. Nota: questo campo non può essere utilizzato per le transazioni relative alle offerte esterne.
Campo unione transaction_type. Il tipo di transazione eseguita. transaction_type può essere solo uno dei seguenti:
oneTimeTransaction

object (OneTimeExternalTransaction)

Si tratta di una transazione una tantum e non fa parte di un abbonamento.
recurringTransaction

object (RecurringExternalTransaction)

Questa transazione fa parte di una serie di transazioni ricorrenti.

ExternalTransactionTestPurchase

Questo tipo non contiene campi.

Rappresenta una transazione eseguita utilizzando un account di test. Google non addebiterà queste transazioni.

OneTimeExternalTransaction

Rappresenta una transazione una tantum.

Rappresentazione JSON 
{
  "externalTransactionToken": string
}
Campi
externalTransactionToken

string

Solo input. Fornito durante la chiamata a Create. Recuperato dal client quando viene avviato il flusso di fatturazione alternativa.

RecurringExternalTransaction

Rappresenta una transazione che fa parte di una serie ricorrente di pagamenti. Può trattarsi di un abbonamento o di un prodotto una tantum con più pagamenti (ad esempio la prenotazione).

Rappresentazione JSON 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
Campi

Campo unione source.

source può essere solo uno dei seguenti:
initialExternalTransactionId

string

L'ID transazione esterno della prima transazione di questa serie di transazioni ricorrenti. Ad esempio, per un abbonamento si tratta dell'ID transazione del primo pagamento. Obbligatorio quando crei transazioni esterne ricorrenti.
externalTransactionToken

string

Solo input. Fornito durante la chiamata a Create. Recuperato dal client quando viene avviato il flusso di fatturazione alternativa. Obbligatorio solo per l'acquisto iniziale.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Solo input. Fornito durante la chiamata a Create. Deve essere utilizzato solo per la migrazione di un abbonamento dai report mensili manuali ai report automatici.
Campo unione product_details. Obbligatorio. Dettagli del prodotto nella transazione esterna ricorrente. product_details può essere solo uno dei seguenti:
externalSubscription

object (ExternalSubscription)

Dettagli di un abbonamento esterno.
otherRecurringProduct

object (OtherRecurringProduct)

Dettagli di un prodotto di transazioni esterne ricorrenti che non appartiene a nessun'altra categoria specifica.

ExternalTransactionProgram

Rappresenta il programma di transazioni esterne utilizzato dall'utente per completare la transazione.

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Programma di transazioni non specificato. Non utilizzato.
USER_CHOICE_BILLING Fatturazione scelta dall'utente, in cui un utente può scegliere tra la fatturazione gestita dallo sviluppatore di Google Play Billing.
ALTERNATIVE_BILLING_ONLY Solo fatturazione alternativa, in cui gli utenti possono utilizzare solo la fatturazione per gli sviluppatori-gestori.

ExternalSubscription

Dettagli di un abbonamento esterno.

Rappresentazione JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
Campi
subscriptionType

enum (SubscriptionType)

Obbligatorio. Il tipo di abbonamento esterno.

SubscriptionType

I tipi di un abbonamento esterno.

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED Non specificato, non utilizzare.
RECURRING Si tratta di un abbonamento ricorrente per cui all'utente viene addebitato l'importo ogni ciclo di fatturazione.
PREPAID Si tratta di un abbonamento prepagato in cui l'utente paga in anticipo.

OtherRecurringProduct

Questo tipo non contiene campi.

Dettagli di un prodotto di transazioni esterne ricorrenti che non appartiene ad altre categorie più specifiche.

TransactionState

Lo stato di una transazione in corso.

Enum
TRANSACTION_STATE_UNSPECIFIED Stato transazione non specificato. Non utilizzato.
TRANSACTION_REPORTED La transazione è stata segnalata a Google.
TRANSACTION_CANCELED La transazione è stata rimborsata per intero.

ExternalTransactionAddress

Indirizzo dell'utente per la transazione esterna.

Rappresentazione JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
Campi
regionCode

string

Obbligatorio. Codice regione di due lettere basato su ISO-3166-1 Alpha-2 (codici regione delle Nazioni Unite).
administrativeArea

string

Facoltativo. Suddivisione amministrativa di primo livello del paese/della regione. Obbligatorio solo per le transazioni in India. I valori validi sono "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN AND DIU", "DAMAN AND DIU", "DELHI", "GOA", "GUJARAT", "HARYANA", "HIMACHAL PRADESH", "JAMMU AND KASHMIR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PUNJAB", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND" e "WEST BENGAL".

Metodi

createexternaltransaction

 Crea una nuova transazione esterna.

getexternaltransaction

 Recupera una transazione esterna esistente.

refundexternaltransaction

 Rimborsa o rimborsa parzialmente una transazione esterna esistente.