Method: externaltransactions.createexternaltransaction

একটি নতুন বাহ্যিক লেনদেন তৈরি করে।

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। মূল সম্পদ যেখানে এই বাহ্যিক লেনদেন তৈরি করা হবে। বিন্যাস: অ্যাপ্লিকেশন/{packageName}

ক্যোয়ারী প্যারামিটার

পরামিতি
externalTransactionId

string

প্রয়োজন। বাহ্যিক লেনদেনের জন্য ব্যবহার করা আইডি। অ্যাপের জন্য অন্য সব লেনদেন জুড়ে অনন্য হতে হবে। এই মান 1-63 অক্ষর হওয়া উচিত এবং বৈধ অক্ষর /a-zA-Z0-9_-/। ইমেলের মতো ব্যক্তিগতভাবে সনাক্তযোগ্য তথ্য (PII) সংরক্ষণ করতে এই ক্ষেত্রটি ব্যবহার করবেন না। এই ক্ষেত্রে PII সঞ্চয় করার প্রচেষ্টার ফলে অনুরোধগুলি ব্লক করা হতে পারে৷

শরীরের অনুরোধ

অনুরোধের মূল অংশে 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