Method: externaltransactions.createexternaltransaction

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक
• इसे आज़माएं!

एक नया बाहरी लेन-देन बनाता है.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
parent	string ज़रूरी है. वह पैरंट रिसॉर्स जहां यह बाहरी लेन-देन बनाया जाएगा. फ़ॉर्मैट: applications/{packageName}

क्वेरी पैरामीटर

पैरामीटर

externalTransactionId

string ज़रूरी है. बाहरी लेन-देन के लिए इस्तेमाल किया जाने वाला आईडी. यह वैल्यू, ऐप्लिकेशन के सभी अन्य लेन-देन के लिए यूनीक होनी चाहिए. इस वैल्यू में 1 से 63 वर्ण होने चाहिए. साथ ही, इसमें /a-zA-Z0-9_-/ वर्ण इस्तेमाल किए जा सकते हैं. इस फ़ील्ड का इस्तेमाल, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) को सेव करने के लिए न करें. जैसे, ईमेल. इस फ़ील्ड में व्यक्तिगत पहचान से जुड़ी जानकारी सेव करने की कोशिश करने पर, अनुरोधों को ब्लॉक किया जा सकता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में ExternalTransaction का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में ExternalTransaction का नया इंस्टेंस शामिल किया जाता है.

नमूना

अनुरोध का सैंपल यहां दिया गया है:

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" \
    } \
  }'

यहां जवाब का एक सैंपल दिया गया है:

{
  "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"
  }
}

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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