Method: externaltransactions.createexternaltransaction

Erstellt eine neue externe Transaktion.

HTTP-Anfrage

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=applications/*}/externalTransactions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese externe Transaktion erstellt wird. Format: applications/{packageName}

Abfrageparameter

Parameter
externalTransactionId

string

Erforderlich. Die ID, die für die externe Transaktion verwendet werden soll. Muss für alle anderen Transaktionen in der App eindeutig sein. Dieser Wert sollte 1–63 Zeichen umfassen und gültige Zeichen sind /a-zA-Z0-9_-/. Verwenden Sie dieses Feld nicht, um personenidentifizierbare Informationen wie E-Mail-Adressen zu speichern. Der Versuch, personenbezogene Daten in diesem Feld zu speichern, kann dazu führen, dass Anfragen blockiert werden.

Anfragetext

Der Anfragetext enthält eine Instanz von ExternalTransaction.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von ExternalTransaction.

Beispiel

Hier ein Beispiel für eine Anfrage:

curl \   -X POST \   'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions?externalTransactionId=exampleExternalTransactionId' \   -H 'Accept: application/json' \   -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \   -H 'Content-Type: application/json' \   -d '{ \     "originalPreTaxAmount": { \       "currency": "USD", \       "priceMicros": "1000000" \     }, \     "originalTaxAmount": { \       "currency": "USD", \       "priceMicros": "100000" \     }, \     "transactionTime": "2023-05-05T12:00:00Z", \     "oneTimeTransaction": { \       "externalTransactionToken": "token-123" \     }, \     "userTaxAddress": { \       "regionCode": "US" \     } \   }'

Hier ist eine Beispielantwort:

{   "createTime": "2023-04-20T14:23:18.121Z",   "currentPreTaxAmount": {     "currency": "USD",     "priceMicros": "12000000"   },   "currentTaxAmount": {     "currency": "USD",     "priceMicros": "1200000"   },   "externalTransactionId": "ext-trans-id-1234",   "oneTimeTransaction": {     "externalTransactionToken": "one-time-token-abc"   },   "originalPreTaxAmount": {     "currency": "USD",     "priceMicros": "15000000"   },   "originalTaxAmount": {     "currency": "USD",     "priceMicros": "1500000"   },   "packageName": "com.example.app",   "recurringTransaction": {     "externalSubscription": {       "subscriptionType": "RECURRING"     },     "externalTransactionToken": "recurring-token-xyz",     "initialExternalTransactionId": "ext-trans-id-5678",     "otherRecurringProduct": {}   },   "testPurchase": {},   "transactionProgramCode": 11,   "transactionState": "TRANSACTION_REPORTED",   "transactionTime": "2023-04-20T14:20:00.000Z",   "userTaxAddress": {     "regionCode": "US"   } }

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/androidpublisher