REST Resource: externaltransactions

Ressource: ExternalTransaction

Die Details einer externen Transaktion.

JSON-Darstellung 
{
  "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.
}
Felder
packageName

string

Nur Ausgabe. Der Ressourcenname der externen Transaktion. Der Paketname der App, in der die In-App-Produkte verkauft wurden (z. B. „com.some.app“).
externalTransactionId

string

Nur Ausgabe. Die ID dieser Transaktion. Alle Transaktions-IDs unter demselben Paketnamen müssen eindeutig sein. Wird beim Erstellen der externen Transaktion festgelegt.
originalPreTaxAmount

object (Price)

Erforderlich. Der ursprüngliche Transaktionsbetrag vor Steuern. Dies ist der Betrag vor Steuern, der Google ursprünglich vor der Anwendung von Erstattungen mitgeteilt wurde.
originalTaxAmount

object (Price)

Erforderlich. Der ursprüngliche Steuerbetrag. Dies ist der Steuerbetrag, der Google ursprünglich mitgeteilt wurde, bevor Erstattungen angewendet wurden.
currentPreTaxAmount

object (Price)

Nur Ausgabe. Der aktuelle Transaktionsbetrag vor Steuern. Dies ist der aktuelle Betrag vor Steuern, einschließlich aller Erstattungen, die möglicherweise auf diese Transaktion angewendet wurden.
currentTaxAmount

object (Price)

Nur Ausgabe. Der aktuelle Steuerbetrag. Dies ist der aktuelle Steuerbetrag einschließlich aller Erstattungen, die möglicherweise auf diese Transaktion angewendet wurden.
testPurchase

object (ExternalTransactionTestPurchase)

Nur Ausgabe. Wenn festgelegt, war diese Transaktion ein Testkauf. Google berechnet keine Gebühren für eine Testtransaktion.
transactionTime

string (Timestamp format)

Erforderlich. Der Zeitpunkt, zu dem die Transaktion abgeschlossen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem diese Transaktion erstellt wurde. Dies ist der Zeitpunkt, zu dem Google über die Transaktion benachrichtigt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
transactionState

enum (TransactionState)

Nur Ausgabe. Der aktuelle Status der Transaktion.
userTaxAddress

object (ExternalTransactionAddress)

Erforderlich. Nutzeradresse für die Steuerberechnung.
transactionProgramCode

integer

Optional. Der Transaktionsprogrammcode wird verwendet, um die Servicegebühr für berechtigte Apps zu ermitteln, die an Partnerprogrammen teilnehmen. Entwickler, die am Play Media Experience Program (https://play.google.com/console/about/programs/mediaprogram/) teilnehmen, müssen den Programmcode angeben, wenn sie alternative Abrechnungstransaktionen melden. Wenn Sie ein berechtigter Entwickler sind, wenden Sie sich bitte an Ihren BDM, um weitere Informationen darüber zu erhalten, wie Sie dieses Feld einstellen können. Hinweis: Dieses Feld kann nicht für Transaktionen mit externen Angeboten verwendet werden.
Die Art der durchgeführten Transaktion. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
oneTimeTransaction

object (OneTimeExternalTransaction)

Dies ist eine einmalige Transaktion und kein Teil eines Abos.
recurringTransaction

object (RecurringExternalTransaction)

Diese Transaktion ist Teil einer Reihe wiederkehrender Transaktionen.
Ende der sich gegenseitig ausschließenden Felder.
Programmspezifische Details, die für die Transaktionsmeldung erforderlich sind. Die Details sollten nur für das Programm festgelegt werden, mit dem die Transaktion verknüpft ist. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
externalOfferDetails

object (ExternalOfferDetails)

Optional. Details, die für die korrekte Meldung von Transaktionen mit externen Angeboten erforderlich sind.
externalContentLinkDetails

object (ExternalContentLinkDetails)

Optional. Angaben, die für eine korrekte Meldung von Transaktionen mit externen Inhaltslinks erforderlich sind.
Ende der sich gegenseitig ausschließenden Felder.

ExternalTransactionTestPurchase

Dieser Typ hat keine Felder.

Stellt eine Transaktion dar, die mit einem Testkonto ausgeführt wurde. Diese Transaktionen werden nicht von Google in Rechnung gestellt.

OneTimeExternalTransaction

Stellt eine einmalige Transaktion dar.

JSON-Darstellung 
{
  "externalTransactionToken": string
}
Felder
externalTransactionToken

string

Nur Eingabe. Wird während des Aufrufs von „Create“ angegeben. Wird vom Client abgerufen, wenn der alternative Abrechnungsablauf gestartet wird.

RecurringExternalTransaction

Stellt eine Transaktion dar, die Teil einer wiederkehrenden Reihe von Zahlungen ist. Dies kann ein Abonnement oder ein Einmalkaufprodukt mit mehreren Zahlungen (z. B. Vorbestellung) sein.

JSON-Darstellung 
{

  // 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.
}
Felder
Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
initialExternalTransactionId

string

Die ID der externen Transaktion der ersten Transaktion dieser wiederkehrenden Transaktionsreihe. Bei einem Abo wäre das beispielsweise die Transaktions-ID der ersten Zahlung. Erforderlich beim Erstellen wiederkehrender externer Transaktionen.
externalTransactionToken

string

Nur Eingabe. Wird während des Aufrufs von „Create“ angegeben. Wird vom Client abgerufen, wenn der alternative Abrechnungsablauf gestartet wird. Nur für den ersten Kauf erforderlich.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Nur Eingabe. Wird während des Aufrufs von „Create“ angegeben. Darf nur verwendet werden, wenn ein Abo von der manuellen monatlichen Berichterstellung zur automatischen Berichterstellung migriert wird.
Ende der sich gegenseitig ausschließenden Felder.
Erforderlich. Details zum Produkt in der wiederkehrenden externen Transaktion. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
externalSubscription

object (ExternalSubscription)

Details zu einem externen Abo.
otherRecurringProduct

object (OtherRecurringProduct)

Details zu einem Produkt für wiederkehrende externe Transaktionen, das keiner anderen spezifischen Kategorie angehört.
Ende der sich gegenseitig ausschließenden Felder.

ExternalTransactionProgram

Gibt das Programm für externe Transaktionen an, das der Nutzer verwendet hat, um die Transaktion abzuschließen.

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Nicht angegebenes Transaktionsprogramm. Nicht verwendet.
USER_CHOICE_BILLING Abrechnung mit Auswahlmöglichkeit für Nutzer, bei der ein Nutzer zwischen Google Play Billing und der vom Entwickler verwalteten Abrechnung wählen kann.
ALTERNATIVE_BILLING_ONLY Nur alternative Abrechnung, bei der Nutzer nur die Abrechnung über den Entwickler-Manager verwenden können.

ExternalSubscription

Details zu einem externen Abo.

JSON-Darstellung 
{
  "subscriptionType": enum (SubscriptionType)
}
Felder
subscriptionType

enum (SubscriptionType)

Erforderlich. Der Typ des externen Abos.

SubscriptionType

Die Arten eines externen Abos.

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Nicht angegeben, nicht verwenden.
RECURRING Dies ist ein Abo mit wiederkehrenden Zahlungen, bei dem dem Nutzer in jedem Abrechnungszeitraum Kosten in Rechnung gestellt werden.
PREPAID Dies ist ein Prepaid-Abo, bei dem der Nutzer im Voraus bezahlt.

OtherRecurringProduct

Dieser Typ hat keine Felder.

Details zu einem Produkt für wiederkehrende externe Transaktionen, das keiner anderen spezifischeren Kategorie angehört.

TransactionState

Der Status einer Transaktion.

Enums
TRANSACTION_STATE_UNSPECIFIED Nicht angegebener Transaktionsstatus. Nicht verwendet.
TRANSACTION_REPORTED Die Transaktion wurde erfolgreich an Google gemeldet.
TRANSACTION_CANCELED Die Transaktion wurde vollständig erstattet.

ExternalTransactionAddress

Die Adresse des Nutzers für die externe Transaktion.

JSON-Darstellung 
{
  "regionCode": string,
  "administrativeArea": string
}
Felder
regionCode

string

Erforderlich. Zweistelliger Regionscode basierend auf ISO-3166-1 Alpha-2 (UN-Regionscodes).
administrativeArea

string

Optional. Administrator der höchsten administrativen Untereinheit des Landes/der Region. Nur für Transaktionen in Indien erforderlich. Gültige Werte sind „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 UND 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" und "WESTBENGALEN".

ExternalOfferDetails

Berichtsdetails, die nur für das Programm für externe Angebote gelten.

JSON-Darstellung 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Felder
installedAppPackage

string

Optional. Der Paketname der App, die über diese Transaktion heruntergeladen wurde. Erforderlich, wenn „linkType“ den Wert „LINK_TO_APP_DOWNLOAD“ hat.
installedAppCategory

enum (ExternalOfferAppCategory)

Optional. Die Kategorie der über diese Transaktion heruntergeladenen App. Diese muss mit der Kategorie übereinstimmen, die in der Play Console während des App-Überprüfungsprozesses für externe Apps angegeben wurde. Nur für App-Downloads erforderlich.
appDownloadEventExternalTransactionId

string

Optional. Die ID für die externe Transaktion, die über einen externen Link mit dem App-Download-Ereignis verknüpft ist. Erforderlich, wenn Sie Transaktionen melden, die in extern installierten Apps ausgeführt wurden.

ExternalOfferLinkType

Der Typ des externen Links.

Enums
LINK_TO_DIGITAL_CONTENT_OFFER Ein Angebot zum Kauf digitaler Inhalte.

ExternalOfferAppCategory

Kategorie der heruntergeladenen App. Weitere Informationen zu App-Kategorien finden Sie unter https://support.google.com/googleplay/android-developer/answer/9859673.

Enums
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Nicht angegeben, nicht verwenden.
APP Die App wird in der App-Kategorie klassifiziert.
GAME Die App wird in der Kategorie „Spiele“ klassifiziert.

ExternalContentLinkDetails

Berichtsdetails, die nur für das Programm für Links zu externen Inhalten gelten.

JSON-Darstellung 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
Felder
installedAppPackage

string

Optional. Der Paketname der App, die über diese Transaktion heruntergeladen wurde. Nur für App-Installationen erforderlich.
externalAppCategory

enum (ExternalContentAppCategory)

Optional. Die Kategorie der heruntergeladenen App. Sie muss mit der Kategorie übereinstimmen, die in der Play Console während der App-Überprüfung angegeben wurde. Nur für App-Installationen erforderlich.

ExternalContentLinkType

Der Typ des externen Links.

Enums
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED Nicht angegeben, nicht verwenden.
LINK_TO_DIGITAL_CONTENT_OFFER Ein Angebot zum Kauf digitaler Inhalte.

ExternalContentAppCategory

Kategorie der heruntergeladenen App. Weitere Informationen zu App-Kategorien finden Sie unter https://support.google.com/googleplay/android-developer/answer/9859673.

Enums
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED Nicht angegeben, nicht verwenden.
APP Die App wird in der App-Kategorie klassifiziert.
GAME Die App wird in der Kategorie „Spiele“ klassifiziert.

Methoden

createexternaltransaction

 Erstellt eine neue externe Transaktion.

getexternaltransaction

 Ruft eine vorhandene externe Transaktion ab.

refundexternaltransaction

 Erstattet eine vorhandene externe Transaktion vollständig oder teilweise.

Fehlercodes

Die Operationen dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Beschreibung Auflösung