REST Resource: externaltransactions

Risorsa: transazione esterna

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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
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 esempio "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 al lordo delle imposte. Rappresenta l'importo al lordo delle imposte originariamente comunicato a Google prima dell'applicazione di eventuali rimborsi.
originalTaxAmount

object (Price)

Obbligatorio. L'importo originale della tassa. Rappresenta l'importo delle tasse originariamente comunicato a Google prima dell'applicazione di eventuali rimborsi.
currentPreTaxAmount

object (Price)

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

object (Price)

Solo output. L'importo attuale delle imposte. Questa cifra rappresenta l'importo attuale delle imposte, inclusi eventuali rimborsi applicati a questa transazione.
testPurchase

object (ExternalTransactionTestPurchase)

Solo output. Se impostata, questa transazione era un acquisto di prova. Google non addebiterà alcun costo per una transazione di prova.
transactionTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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".
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata questa transazione. Questo è il momento in cui Google è stato informato della transazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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".
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 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 le 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 di offerte esterne.
Il tipo di transazione eseguita. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
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.
Fine dei campi che si escludono a vicenda.
Dettagli specifici del programma necessari per la generazione di report sulle transazioni. I dettagli devono essere impostati solo per il programma a cui è associata la transazione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
externalOfferDetails

object (ExternalOfferDetails)

Facoltativo. Dettagli necessari per segnalare con precisione le transazioni relative a offerte esterne.
externalContentLinkDetails

object (ExternalContentLinkDetails)

Facoltativo. Dettagli necessari per segnalare con precisione le transazioni con link a contenuti esterni.
Fine dei campi che si escludono a vicenda.

ExternalTransactionTestPurchase

Questo tipo non contiene campi.

Rappresenta una transazione eseguita utilizzando un account di prova. Queste transazioni non saranno soggette a commissioni da parte di Google.

OneTimeExternalTransaction

Rappresenta una transazione una tantum.

Rappresentazione JSON 
{
  "externalTransactionToken": string
}
Campi
externalTransactionToken

string

Solo input. Fornito durante la chiamata a Crea. Recuperato dal client all'avvio del 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 a pagamento singolo con più pagamenti (ad esempio un preordine).

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
initialExternalTransactionId

string

L'ID transazione esterno della prima transazione di questa serie ricorrente di transazioni. 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 Crea. Recuperato dal client all'avvio del flusso di fatturazione alternativa. Richiesto solo per l'acquisto iniziale.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Solo input. Fornito durante la chiamata a Crea. Deve essere utilizzato solo durante la migrazione di un abbonamento dalla generazione di report mensili manuali a quella automatica.
Fine dei campi che si escludono a vicenda.
Obbligatorio. Dettagli del prodotto nella transazione esterna ricorrente. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
externalSubscription

object (ExternalSubscription)

Dettagli di un abbonamento esterno.
otherRecurringProduct

object (OtherRecurringProduct)

Dettagli di un prodotto di transazione esterna ricorrente che non appartiene a nessun'altra categoria specifica.
Fine dei campi che si escludono a vicenda.

ExternalTransactionProgram

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

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Programma di transazione non specificato. Non utilizzato.
USER_CHOICE_BILLING Fatturazione a scelta dell'utente, in cui l'utente può scegliere tra la fatturazione di Google Play e la fatturazione gestita dallo sviluppatore.
ALTERNATIVE_BILLING_ONLY Solo fatturazione alternativa, in cui gli utenti possono utilizzare solo la fatturazione del gestore 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 viene addebitato un costo 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 transazione esterna ricorrente che non appartiene a nessun'altra categoria più specifica.

TransactionState

Lo stato di una transazione in corso.

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 rimborsata interamente.

ExternalTransactionAddress

L'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/regione. Richiesto 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".

ExternalOfferDetails

Dettagli dei report esclusivi del programma per offerte esterne.

Rappresentazione JSON 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Campi
installedAppPackage

string

Facoltativo. Il nome del pacchetto dell'app scaricata tramite questa transazione. Obbligatorio quando linkType è LINK_TO_APP_DOWNLOAD.
installedAppCategory

enum (ExternalOfferAppCategory)

Facoltativo. La categoria dell'app scaricata tramite questa transazione. Deve corrispondere alla categoria fornita in Play Console durante la procedura di verifica dell'app esterna. Necessario solo per il download dell'app.
appDownloadEventExternalTransactionId

string

Facoltativo. L'ID transazione esterno associato all'evento di download dell'app tramite un link esterno. Obbligatorio quando vengono segnalate transazioni effettuate in app installate esternamente.

ExternalOfferLinkType

Il tipo di link esterno.

Enum
LINK_TO_DIGITAL_CONTENT_OFFER Un'offerta di acquisto di contenuti digitali.

ExternalOfferAppCategory

Categoria dell'app scaricata. Per ulteriori informazioni sulle categorie di app, vedi https://support.google.com/googleplay/android-developer/answer/9859673.

Enum
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Non specificato, non utilizzare.
APP L'app è classificata nella categoria di app.
GAME L'app è classificata nella categoria Giochi.

ExternalContentLinkDetails

Dettagli dei report univoci per il programma per i link a contenuti esterni.

Rappresentazione JSON 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
Campi
installedAppPackage

string

Facoltativo. Il nome del pacchetto dell'app scaricata tramite questa transazione. Obbligatorio solo per le installazioni di app.
externalAppCategory

enum (ExternalContentAppCategory)

Facoltativo. La categoria dell'app scaricata. Questa deve corrispondere alla categoria fornita in Play Console durante il processo di verifica app esterna. Obbligatorio solo per le installazioni di app.

ExternalContentLinkType

Il tipo di link esterno.

Enum
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED Non specificato, non utilizzare.
LINK_TO_DIGITAL_CONTENT_OFFER Un'offerta di acquisto di contenuti digitali.

ExternalContentAppCategory

Categoria dell'app scaricata. Per ulteriori informazioni sulle categorie di app, vedi https://support.google.com/googleplay/android-developer/answer/9859673.

Enum
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED Non specificato, non utilizzare.
APP L'app è classificata nella categoria di app.
GAME L'app è classificata nella categoria Giochi.

Metodi

createexternaltransaction

 Crea una nuova transazione esterna.

getexternaltransaction

 Recupera una transazione esterna esistente.

refundexternaltransaction

 Rimborsa o rimborsa parzialmente una transazione esterna esistente.

Codici di errore

Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:

Codice di errore Motivo Descrizione Risoluzione