- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Crée une transaction externe.
Requête HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=applications/*}/externalTransactions
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Ressource parente dans laquelle cette transaction externe sera créée. Format: applications/{packageName} |
Paramètres de requête
Paramètres | |
---|---|
externalTransactionId |
Obligatoire. ID à utiliser pour la transaction externe. Doit être unique pour toutes les autres transactions de l'application. Cette valeur doit comporter entre 1 et 63 caractères, et les caractères valides sont /a-zA-Z0-9_-/. N'utilisez pas ce champ pour stocker des informations permettant d'identifier personnellement l'utilisateur, comme des adresses e-mail. Toute tentative de stockage d'informations permettant d'identifier personnellement l'utilisateur dans ce champ peut entraîner le blocage des requêtes. |
Corps de la requête
Le corps de la requête contient une instance de ExternalTransaction
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de ExternalTransaction
.
Échantillon
Voici un exemple de requête:
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" \ } \ }'
Voici un exemple de réponse :
{ "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" } }
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/androidpublisher