- Risorsa: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- ExternalOfferInitialAcquisitionDetails
- Metodi
Risorsa: ExternalTransaction
I dettagli di una transazione esterna.
Rappresentazione JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
Campi | |
---|---|
packageName |
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 |
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 |
Obbligatorio. Importo della transazione originale al netto delle imposte. Si tratta dell'importo al lordo delle imposte originariamente comunicato a Google prima dell'applicazione di qualsiasi rimborso. |
originalTaxAmount |
Obbligatorio. L'importo originale delle imposte. Si tratta dell'importo dell'imposta originariamente comunicato a Google prima dell'applicazione di qualsiasi rimborso. |
currentPreTaxAmount |
Solo output. Importo attuale della transazione al netto delle imposte. Rappresenta l'importo corrente al lordo delle imposte, inclusi eventuali rimborsi che potrebbero essere stati applicati a questa transazione. |
currentTaxAmount |
Solo output. L'importo attuale delle imposte. Rappresenta l'importo corrente delle imposte, inclusi eventuali rimborsi che potrebbero essere stati applicati a questa transazione. |
testPurchase |
Solo output. Se impostato, la transazione era un acquisto di prova. Google non addebita alcun costo per una transazione di prova. |
transactionTime |
Obbligatorio. L'ora in cui è stata completata la transazione. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
createTime |
Solo output. L'ora in cui è stata creata la transazione. Si tratta del momento in cui Google è stata informata della transazione. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
transactionState |
Solo output. Stato attuale della transazione. |
userTaxAddress |
Obbligatorio. Indirizzo dell'utente per il calcolo delle imposte. |
transactionProgramCode |
(Facoltativo) Il codice del programma di transazione, 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 per offerte esterne. |
externalOfferInitialAcquisitionDetails |
(Facoltativo) Dettagli sulla prima volta che un utente/dispositivo completa una transazione utilizzando offerte esterne. Non obbligatorio solo per le transazioni effettuate utilizzando la fatturazione scelta dall'utente o solo la fatturazione alternativa. |
Campo unione transaction_type . Il tipo di transazione che è stata eseguita. transaction_type può essere solo uno dei seguenti: |
|
oneTimeTransaction |
Si tratta di una transazione una tantum e non fa parte di un abbonamento. |
recurringTransaction |
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 |
Solo input. Fornito durante la chiamata a Create. Recuperato dal cliente quando viene avviato il flusso di fatturazione alternativa. |
RecurringExternalTransaction
Rappresenta una transazione che fa parte di una serie di pagamenti ricorrenti. Può trattarsi di un abbonamento o di un prodotto a pagamento singolo con più pagamenti (ad es. pre-ordine).
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
initialExternalTransactionId |
L'ID della transazione esterna della prima transazione di questa serie di transazioni ricorrenti. Ad esempio, per un abbonamento si tratta dell'ID transazione del primo pagamento. Obbligatoria quando si creano transazioni esterne ricorrenti. |
externalTransactionToken |
Solo input. Fornito durante la chiamata a Create. Recuperato dal cliente quando viene avviato il flusso di fatturazione alternativa. Obbligatorio solo per l'acquisto iniziale. |
migratedTransactionProgram |
Solo input. Fornito durante la chiamata a Create. Deve essere utilizzato solo quando si esegue 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 |
Dettagli di un abbonamento esterno. |
otherRecurringProduct |
Dettagli di un prodotto ricorrente per transazioni esterne che non appartiene ad altre categorie specifiche. |
ExternalTransactionProgram
Rappresenta il programma per transazioni esterne utilizzato dall'utente per completare la transazione.
Enum | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
Programma di transazione non specificato. Non utilizzato. |
USER_CHOICE_BILLING |
Fatturazione scelta dall'utente, per cui l'utente può scegliere tra la fatturazione gestita dallo sviluppatore con Fatturazione Google Play. |
ALTERNATIVE_BILLING_ONLY |
Solo fatturazione alternativa, dove gli utenti possono utilizzare solo la fatturazione sviluppatore-manager. |
ExternalSubscription
Dettagli di un abbonamento esterno.
Rappresentazione JSON |
---|
{
"subscriptionType": enum ( |
Campi | |
---|---|
subscriptionType |
Obbligatorio. Il tipo di abbonamento esterno. |
SubscriptionType
I tipi di abbonamenti esterni.
Enum | |
---|---|
SUBSCRIPTION_TYPE_UNSPECIFIED |
Non specificato, non utilizzare. |
RECURRING |
Si tratta di un abbonamento ricorrente in cui all'utente viene addebitato un costo per 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
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 |
Obbligatorio. Codice regione di due lettere basato sullo standard ISO-3166-1 Alpha-2 (codici regione UN). |
administrativeArea |
(Facoltativo) Suddivisione amministrativa di primo livello del paese/della regione. Obbligatorio solo per le transazioni in India. 2 |
ExternalOfferInitialAcquisitionDetails
Dettagli sulla prima volta che un utente/dispositivo completa una transazione utilizzando offerte esterne.
Rappresentazione JSON |
---|
{ "externalTransactionId": string } |
Campi | |
---|---|
externalTransactionId |
Obbligatorio. L'ID transazione esterna del primo acquisto completato effettuato dall'utente. |
Metodi |
|
---|---|
|
Crea una nuova transazione esterna. |
|
Recupera una transazione esterna esistente. |
|
Rimborsa o rimborsa parzialmente una transazione esterna esistente. |