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)
  },

  // 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 inapp (ad esempio "com.some.app").
externalTransactionId

string

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

object (Price)

obbligatorio. L'importo della transazione originale al netto 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 delle tasse. Si tratta dell'importo dell'imposta originariamente comunicato a Google prima dell'applicazione di qualsiasi rimborso.
currentPreTaxAmount

object (Price)

Solo output. L'importo della transazione corrente al netto delle imposte. Indica l'importo corrente al lordo delle imposte, inclusi eventuali rimborsi applicati a questa transazione.
currentTaxAmount

object (Price)

Solo output. L'importo dell'imposta corrente. Indica l'importo delle imposte correnti, inclusi eventuali rimborsi applicati a questa transazione.
testPurchase

object (ExternalTransactionTestPurchase)

Solo output. Se impostato, si tratta di 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" RFC3339 UTC, con risoluzione in nanosecondi 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 la transazione. È l'ora in cui Google è stata informata della transazione.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi 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 fiscale.
Campo di 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 ricorrente di transazioni.

ExternalTransactionTestPurchase

Questo tipo non contiene campi.

Rappresenta una transazione eseguita utilizzando un account di prova. Queste transazioni non verranno addebitate da Google.

OneTimeExternalTransaction

Rappresenta una transazione una tantum.

Rappresentazione JSON 
{
  "externalTransactionToken": string
}
Campi
externalTransactionToken

string

Solo input. Fornito durante la chiamata alla creazione. Recuperato dal client quando viene avviato il flusso di fatturazione alternativo.

RecurringExternalTransaction

Rappresenta una transazione che fa parte di una serie ricorrente di pagamenti. Può trattarsi di un abbonamento o di un prodotto a pagamento singolo con più pagamenti (ad esempio, pre-ordine).

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)
  }
  // End of list of possible types for union field product_details.
}
Campi

Campo di unione source.

source può essere solo uno dei seguenti:
initialExternalTransactionId

string

L'ID transazione esterna della prima transazione di questa serie ricorrente di transazioni. Ad esempio, per un abbonamento è l'ID transazione del primo pagamento. Obbligatorio per la creazione di transazioni esterne ricorrenti.
externalTransactionToken

string

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

enum (ExternalTransactionProgram)

Solo input. Fornito durante la chiamata alla creazione. Deve essere utilizzato solo durante la migrazione di un abbonamento dai report mensili manuali ai report automatici.
Campo di 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.

ExternalTransactionProgram

Rappresenta il programma di transazioni esterno 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, che consente all'utente di scegliere tra la fatturazione gestita dallo sviluppatore Fatturazione Google Play.
ALTERNATIVE_BILLING_ONLY Solo fatturazione alternativa, in cui gli utenti possono usare solo la fatturazione sviluppatore.

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 abbonamento esterno.

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED Non specificato, non utilizzare.
RECURRING Si tratta di un abbonamento ricorrente in cui all'utente vengono addebitati tutti i cicli di fatturazione.
PREPAID Si tratta di un abbonamento prepagato in cui l'utente paga in anticipo.

TransactionState

Lo stato di una transazione effettuata.

Enum
TRANSACTION_STATE_UNSPECIFIED Stato della transazione non specificato. Non utilizzato.
TRANSACTION_REPORTED La transazione è stata segnalata correttamente a Google.
TRANSACTION_CANCELED La transazione è stata completamente rimborsata.

ExternalTransactionAddress

Indirizzo dell'utente per la transazione esterna.

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

string

obbligatorio. Codice regione di due lettere basato sullo standard ISO-3166-1 Alpha-2 (codici regione UN).
administrativeArea

string

Campo facoltativo. Suddivisione amministrativa di primo livello del paese/della regione. Obbligatorio solo per le transazioni in India. I valori validi sono "HARKADE, "HARKADE, "HARKA, . ", . ", . ", . ", .

Metodi

createexternaltransaction

 Crea una nuova transazione esterna.

getexternaltransaction

 Recupera una transazione esterna esistente.

refundexternaltransaction

 Consente di rimborsare o rimborsare parzialmente una transazione esterna esistente.