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,

  // 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, über die die In-App-Produkte verkauft wurden (z. B. „com.some.app“).
externalTransactionId

string

Nur Ausgabe. Die ID dieser Transaktion. Alle Transaktions-IDs mit 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 ursprünglich an Google gemeldet wurde, bevor Erstattungen angewendet wurden.
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 auf diese Transaktion angewendet wurden.
currentTaxAmount

object (Price)

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

object (ExternalTransactionTestPurchase)

Nur Ausgabe. Wenn diese Option festgelegt ist, war diese Transaktion ein Testkauf. Google erhebt keine Gebühren für eine Testtransaktion.
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. Die Uhrzeit, zu der diese Transaktion erstellt wurde. Das 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. Adresse des Nutzers für die Steuerberechnung.
transactionProgramCode

integer

Optional. Der Transaktionsprogrammcode, der zur Bestimmung der Servicegebühr für berechtigte Apps verwendet wird, 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 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 mit externen Angeboten verwendet werden.
Union-Feld transaction_type. Die Art der ausgeführten Transaktion. Für transaction_type ist nur einer der folgenden Werte zulässig:
oneTimeTransaction

object (OneTimeExternalTransaction)

Dies ist eine einmalige Transaktion und keine Abo-Transaktion.
recurringTransaction

object (RecurringExternalTransaction)

Diese Transaktion ist Teil einer wiederkehrenden Transaktionsreihe.

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 beim Aufruf von „Erstellen“ angegeben. Wird vom Client abgerufen, wenn der Ablauf für die alternative Abrechnung gestartet wird.

RecurringExternalTransaction

Stellt eine Transaktion dar, die Teil einer wiederkehrenden Reihe von Zahlungen ist. Das kann ein Abo oder ein einmaliges Produkt mit mehreren Zahlungen sein (z. B. eine 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 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 beim Aufruf von „Erstellen“ angegeben. Wird vom Client abgerufen, wenn der Ablauf für die alternative Abrechnung gestartet wird. Nur für den Erstkauf erforderlich.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Nur Eingabe. Wird beim Aufruf von „Erstellen“ angegeben. Darf nur verwendet werden, wenn ein Abo von manuellen monatlichen Berichten zu automatisierten Berichten migriert wird.
Union-Feld product_details. Erforderlich. Details zum Produkt 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 einem wiederkehrenden externen Transaktionsprodukt, das keiner anderen bestimmten Kategorie zugewiesen werden kann.

ExternalTransactionProgram

Stellt das externe Transaktionsprogramm dar, das der Nutzer zum Abschließen der Transaktion verwendet.

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Nicht angegebenes Transaktionsprogramm. Nicht verwendet.
USER_CHOICE_BILLING Abrechnung mit Auswahlmöglichkeit für Nutzer, bei der Nutzer zwischen Google Play Billing und der vom Entwickler verwalteten Abrechnung wählen können.
ALTERNATIVE_BILLING_ONLY Nur alternative Abrechnung, bei der Nutzer nur die Abrechnung über das Entwickler-Verwaltungskonto 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 Typen eines externen Abos.

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Nicht angegeben, nicht verwenden.
RECURRING Dies ist ein wiederkehrendes Abo, bei dem dem Nutzer jeder Abrechnungszeitraum in Rechnung gestellt wird.
PREPAID Dies ist ein Prepaid-Abo, bei dem der Nutzer im Voraus bezahlt.

OtherRecurringProduct

Dieser Typ hat keine Felder.

Details zu einem wiederkehrenden Produkt mit externen Transaktionen, das keiner anderen, genaueren Kategorie zugeordnet werden kann.

TransactionState

Der Status einer Transaktion.

Enums
TRANSACTION_STATE_UNSPECIFIED Nicht angegebener Transaktionsstatus. Nicht verwendet.
TRANSACTION_REPORTED Die Transaktion wurde 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. Die oberste Verwaltungseinheit 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 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“ und „WEST BENGAL“.

Methoden

createexternaltransaction

 Erstellt eine neue externe Transaktion.

getexternaltransaction

 Ruft eine vorhandene externe Transaktion ab.

refundexternaltransaction

 Eine vorhandene externe Transaktion wird erstattet oder teilweise erstattet.