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)
  },

  // 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 App, über die 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. Dieser Betrag entspricht dem Betrag vor Steuern, der ursprünglich Google mitgeteilt wurde, bevor Erstattungen veranlasst wurden.
originalTaxAmount

object (Price)

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

object (Price)

Nur Ausgabe. Der aktuelle Transaktionsbetrag vor Steuern. Dieser Wert entspricht dem aktuellen Betrag vor Steuern, einschließlich etwaiger Erstattungen, die auf diese Transaktion angewendet wurden.
currentTaxAmount

object (Price)

Nur Ausgabe. Der aktuelle Steuerbetrag. Dies entspricht dem aktuellen Steuerbetrag, einschließlich etwaiger Erstattungen, die auf diese Transaktion angewendet wurden.
testPurchase

object (ExternalTransactionTestPurchase)

Nur Ausgabe. Wenn festgelegt, 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 Nanosekundenauflösung 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 benachrichtigt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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. Nutzeradresse für die Steuerberechnung.
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)

Diese Transaktion ist einmalig und nicht Teil eines Abos.
recurringTransaction

object (RecurringExternalTransaction)

Diese Transaktion ist Teil einer wiederkehrenden Reihe von Transaktionen.

ExternalTransactionTestPurchase

Dieser Typ hat keine Felder.

Stellt eine Transaktion dar, die über ein 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. Diese Daten werden vom Kunden abgerufen, wenn der alternative Abrechnungsablauf gestartet wird.

RecurringExternalTransaction

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

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 ist 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. Diese Daten werden vom Kunden abgerufen, wenn der alternative Abrechnungsablauf gestartet wird. Nur für den Erstkauf erforderlich.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Nur Eingabe. Wird während des Aufrufs von Create angegeben. Muss nur bei der Migration eines Abos von der manuellen monatlichen Berichterstellung zur automatischen Berichterstellung verwendet werden.
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 eines externen Abos.
otherRecurringProduct

object (OtherRecurringProduct)

Details eines wiederkehrenden externen Transaktionsprodukts, das zu keiner anderen spezifischen Kategorie gehört.

ExternalTransactionProgram

Stellt das externe Transaktionsprogramm dar, mit dem der Nutzer die Transaktion abschließen kann.

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 die alternative Abrechnung, bei der Nutzer nur die Abrechnung über den Entwicklermanager verwenden können

ExternalSubscription

Details eines externen Abos.

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 Ohne Angabe, nicht verwenden.
RECURRING Dies ist ein wiederkehrendes Abo, 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 wiederkehrenden externen Transaktionsprodukt, das zu keiner anderen spezifischen Kategorie gehört.

TransactionState

Der Status einer durchgeführten 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. Der aus zwei Buchstaben bestehende Regionscode auf Grundlage von ISO-3166-1 Alpha-2 (UN-Regionscodes).
administrativeArea

string

Optional. Oberste Verwaltungseinheit des Landes/der Region. Nur für Transaktionen in Indien erforderlich. DOKRAN-MAN-, DARSCHMANN, DER SCHAR.- UND TRADEDESCHADESCH, PRADESCH, ARUNACH, DER KARUSSEN, DER TRARANAMITAR.

Methoden

createexternaltransaction

 Erstellt eine neue externe Transaktion.

getexternaltransaction

 Ruft eine vorhandene externe Transaktion ab.

refundexternaltransaction

 Hiermit werden bestehende externe Transaktionen erstattet oder teilweise erstattet.