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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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.
}
Felder
packageName

string

Nur Ausgabe. Der Ressourcenname der externen Transaktion. Der Paketname der Anwendung, 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 einem Paketnamen müssen eindeutig sein. Wird beim Erstellen der externen Transaktion festgelegt.

originalPreTaxAmount

object (Price)

Erforderlich. Der ursprüngliche Transaktionsbetrag vor Steuern. Dies entspricht dem Betrag vor Steuern, der Google ursprünglich mitgeteilt wurde, bevor Erstattungen vorgenommen wurden.

originalTaxAmount

object (Price)

Erforderlich. Der ursprüngliche Steuerbetrag. Dies entspricht dem Steuerbetrag, der Google ursprünglich mitgeteilt wurde, bevor Erstattungen vorgenommen wurden.

currentPreTaxAmount

object (Price)

Nur Ausgabe. Der aktuelle Transaktionsbetrag vor Steuern. Entspricht dem aktuellen Betrag vor Steuern, einschließlich aller Rückerstattungen, die auf diese Transaktion angewendet wurden.

currentTaxAmount

object (Price)

Nur Ausgabe. Der aktuelle Steuerbetrag. Der aktuelle Steuerbetrag, einschließlich aller Rückerstattungen, die für diese Transaktion möglicherweise angefallen sind.

testPurchase

object (ExternalTransactionTestPurchase)

Nur Ausgabe. Wenn festgelegt, war diese Transaktion ein Testkauf. Google stellt die Testtransaktion nicht in Rechnung.

transactionTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

createTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

transactionState

enum (TransactionState)

Nur Ausgabe. Der aktuelle Status der Transaktion.

userTaxAddress

object (ExternalTransactionAddress)

Erforderlich. Benutzeradresse für die Steuerberechnung.

transactionProgramCode

integer

Optional. Der Code des Transaktionsprogramms, mit dem die Servicegebühr für infrage kommende Apps, die an Partnerprogrammen teilnehmen, berechnet wird. Entwickler, die am Play Media Experience Program (https://play.google.com/console/about/programs/mediaprogram/) teilnehmen, müssen den Programmcode angeben, wenn sie Transaktionen mit alternativer Abrechnung melden. Wenn Sie ein berechtigter Entwickler sind, wenden Sie sich bitte an Ihren BDM, um weitere Informationen zum Festlegen dieses Felds zu erhalten. Hinweis: Dieses Feld kann nicht für Transaktionen für externe Angebote verwendet werden.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

Optional. Details zum ersten Abschluss einer Transaktion durch einen Nutzer oder ein Gerät über externe Angebote. Nicht erforderlich für Transaktionen, die nur über die Abrechnung mit Auswahlmöglichkeit für Nutzer oder die alternative Abrechnung erfolgen.

Union-Feld transaction_type. Die Art der durchgeführten Transaktion. Für transaction_type ist nur einer der folgenden Werte zulässig:
oneTimeTransaction

object (OneTimeExternalTransaction)

Dies ist eine einmalige Transaktion und kein Bestandteil eines Abonnements.

recurringTransaction

object (RecurringExternalTransaction)

Diese Transaktion ist Teil einer wiederkehrenden Reihe von Transaktionen.

ExternalTransactionTestPurchase

Dieser Typ hat keine Felder.

Eine Transaktion, die über ein Testkonto ausgeführt wurde Diese Transaktionen werden von Google nicht in Rechnung gestellt.

OneTimeExternalTransaction

Stellt eine einmalige Transaktion dar.

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

string

Nur Eingabe. Wird während des Aufrufs zur Erstellung angegeben. Wird vom Client abgerufen, wenn der alternative Abrechnungsablauf gestartet wird.

RecurringExternalTransaction

Eine Transaktion, die Teil einer wiederkehrenden Zahlungsreihe ist. Dabei kann es sich um ein Abo oder ein Einmalkaufprodukt mit mehreren Zahlungen handeln (z. B. Vorbestellung).

JSON-Darstellung
{

  // 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.
}
Felder

Union-Feld source.

Für source ist nur einer der folgenden Werte zulässig:

initialExternalTransactionId

string

Die externe Transaktions-ID der ersten Transaktion dieser wiederkehrenden Reihe von Transaktionen. Bei einem Abo wäre dies beispielsweise die Transaktions-ID der ersten Zahlung. Erforderlich beim Erstellen wiederkehrender externer Transaktionen.

externalTransactionToken

string

Nur Eingabe. Wird während des Aufrufs zur Erstellung angegeben. Wird vom Client abgerufen, wenn der alternative Abrechnungsablauf gestartet wird. Nur für den Erstkauf erforderlich.

migratedTransactionProgram

enum (ExternalTransactionProgram)

Nur Eingabe. Wird während des Aufrufs zur Erstellung angegeben. Kann nur verwendet werden, wenn ein Abo von der manuellen monatlichen Berichterstellung zur automatischen Berichterstellung migriert wird.

Union-Feld product_details. Erforderlich. Details des Produkts in der wiederkehrenden externen Transaktion. Für product_details ist nur einer der folgenden Werte zulässig:
externalSubscription

object (ExternalSubscription)

Details zu einem externen Abo.

otherRecurringProduct

object (OtherRecurringProduct)

Details zu wiederkehrenden externen Transaktionsprodukten, die zu keiner anderen spezifischen Kategorie gehören.

ExternalTransactionProgram

Stellt das externe Transaktionsprogramm dar, das der Nutzer zum Abschließen der Transaktion ausgeführt hat.

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 der vom Entwickler verwalteten Abrechnung über Google Play Billing wählen kann.
ALTERNATIVE_BILLING_ONLY Nur für die alternative Abrechnung; Nutzer dürfen nur die Abrechnung über das Entwicklermanager-Konto verwenden.

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 spezifiziert, nicht verwenden.
RECURRING Dies ist ein wiederkehrendes Abo, bei dem dem Nutzer für jeden 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 wiederkehrenden externen Transaktionsprodukten, die zu keiner anderen spezifischeren Kategorie gehören.

TransactionState

Der Status einer durchgeführten Transaktion.

Enums
TRANSACTION_STATE_UNSPECIFIED Transaktionsstatus nicht angegeben Nicht verwendet.
TRANSACTION_REPORTED Die Transaktion wurde Google gemeldet.
TRANSACTION_CANCELED Die Transaktion wurde vollständig erstattet.

ExternalTransactionAddress

Adresse des Nutzers für die externe Transaktion.

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

string

Erforderlich. Der aus zwei Buchstaben bestehende Regionscode basierend auf ISO-3166-1 Alpha-2 (UN-Regionscodes).

administrativeArea

string

Optional. Übergeordnete Verwaltungseinheit des Landes/der Region. Nur für Transaktionen in Indien erforderlich. Er

ExternalOfferInitialAcquisitionDetails

Details zum ersten Abschluss einer Transaktion durch einen Nutzer oder ein Gerät über externe Angebote.

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

string

Erforderlich. Die externe Transaktions-ID des ersten abgeschlossenen Kaufs des Nutzers.

Methoden

createexternaltransaction

Erstellt eine neue externe Transaktion.

getexternaltransaction

Ruft eine vorhandene externe Transaktion ab.

refundexternaltransaction

Rückerstattungen oder Teilerstattungen einer bestehenden externen Transaktion