REST Resource: externaltransactions

রিসোর্স: এক্সটার্নাল ট্রানজ্যাকশন

একটি বাহ্যিক লেনদেনের বিবরণ।

JSON উপস্থাপনা 
{
  "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)
  },
  "transactionProgramCode": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
ক্ষেত্র
packageName

string

শুধুমাত্র আউটপুট। বাহ্যিক লেনদেনের রিসোর্স নাম। যে অ্যাপ্লিকেশনের ইন-অ্যাপ পণ্যগুলো বিক্রি করা হয়েছিল তার প্যাকেজ নাম (উদাহরণস্বরূপ, 'com.some.app')।

externalTransactionId

string

শুধুমাত্র আউটপুট। এই ট্রানজ্যাকশনের আইডি। একই প্যাকেজ নামের অধীনে থাকা সমস্ত ট্রানজ্যাকশন আইডি অবশ্যই অনন্য হতে হবে। এক্সটার্নাল ট্রানজ্যাকশন তৈরি করার সময় এটি সেট করা হয়।

originalPreTaxAmount

object ( Price )

প্রয়োজনীয়। কর-পূর্ববর্তী মূল লেনদেনের পরিমাণ। এটি সেই কর-পূর্ববর্তী পরিমাণ যা কোনো অর্থ ফেরত দেওয়ার আগে গুগলকে প্রাথমিকভাবে জানানো হয়েছিল।

originalTaxAmount

object ( Price )

প্রয়োজনীয়। মূল করের পরিমাণ। এটি সেই করের পরিমাণ যা কোনো অর্থ ফেরত দেওয়ার আগে গুগলকে প্রাথমিকভাবে জানানো হয়েছিল।

currentPreTaxAmount

object ( Price )

শুধুমাত্র আউটপুট। কর-পূর্ববর্তী বর্তমান লেনদেনের পরিমাণ। এটি বর্তমান কর-পূর্ববর্তী পরিমাণকে বোঝায়, যার মধ্যে এই লেনদেনে প্রযোজ্য যেকোনো ফেরত অন্তর্ভুক্ত রয়েছে।

currentTaxAmount

object ( Price )

শুধুমাত্র আউটপুট। বর্তমান করের পরিমাণ। এটি বর্তমান করের পরিমাণকে বোঝায়, যার মধ্যে এই লেনদেনের ক্ষেত্রে প্রযোজ্য যেকোনো ফেরতও অন্তর্ভুক্ত রয়েছে।

testPurchase

object ( ExternalTransactionTestPurchase )

শুধুমাত্র আউটপুট। যদি এটি সেট করা থাকে, তাহলে এই লেনদেনটি একটি পরীক্ষামূলক ক্রয় ছিল। Google পরীক্ষামূলক লেনদেনের জন্য কোনো চার্জ করবে না।

transactionTime

string ( Timestamp format)

প্রয়োজনীয়। লেনদেনটি সম্পন্ন হওয়ার সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। এই লেনদেনটি তৈরি হওয়ার সময়। এই সময়ে গুগলকে লেনদেনটি সম্পর্কে অবহিত করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

transactionState

enum ( TransactionState )

শুধুমাত্র আউটপুট। ট্রানজ্যাকশনটির বর্তমান অবস্থা।

userTaxAddress

object ( ExternalTransactionAddress )

কর গণনার জন্য ব্যবহারকারীর ঠিকানা আবশ্যক।

transactionProgramCode

integer

ঐচ্ছিক। এই ট্রানজ্যাকশন প্রোগ্রাম কোডটি পার্টনার প্রোগ্রামে অংশগ্রহণকারী যোগ্য অ্যাপগুলির জন্য সার্ভিস ফি নির্ধারণ করতে সাহায্য করে। প্লে মিডিয়া এক্সপেরিয়েন্স প্রোগ্রামে ( https://play.google.com/console/about/programs/mediaprogram/ ) অংশগ্রহণকারী ডেভেলপারদের বিকল্প বিলিং ট্রানজ্যাকশন রিপোর্ট করার সময় অবশ্যই এই প্রোগ্রাম কোডটি প্রদান করতে হবে। আপনি যদি একজন যোগ্য ডেভেলপার হন, তবে এই ফিল্ডটি কীভাবে সেট করতে হয় সে সম্পর্কে আরও তথ্যের জন্য অনুগ্রহ করে আপনার BDM-এর সাথে যোগাযোগ করুন। দ্রষ্টব্য: এই ফিল্ডটি এক্সটার্নাল অফার ট্রানজ্যাকশনের জন্য ব্যবহার করা যাবে না।

সম্পাদিত লেনদেনের ধরণ। নিম্নলিখিতটি হলো পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
oneTimeTransaction

object ( OneTimeExternalTransaction )

এটি একটি এককালীন লেনদেন এবং কোনো সাবস্ক্রিপশনের অংশ নয়।

recurringTransaction

object ( RecurringExternalTransaction )

এই লেনদেনটি একটি পুনরাবৃত্তিমূলক লেনদেন ধারার অংশ।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।
লেনদেন রিপোর্টিংয়ের জন্য প্রয়োজনীয় প্রোগ্রাম-নির্দিষ্ট বিবরণ। এই বিবরণগুলো শুধুমাত্র সেই প্রোগ্রামের জন্যই সেট করা উচিত, যার সাথে লেনদেনটি সংশ্লিষ্ট। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
externalOfferDetails

object ( ExternalOfferDetails )

ঐচ্ছিক। বাহ্যিক অফার লেনদেন সঠিকভাবে প্রতিবেদন করার জন্য প্রয়োজনীয় বিবরণ।

externalContentLinkDetails

object ( ExternalContentLinkDetails )

ঐচ্ছিক। বাহ্যিক কন্টেন্ট লিঙ্ক লেনদেন সঠিকভাবে রিপোর্ট করার জন্য প্রয়োজনীয় বিবরণ।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

বাহ্যিক লেনদেন পরীক্ষা ক্রয়

এই প্রকারে কোনো ক্ষেত্র নেই।

এটি একটি পরীক্ষামূলক অ্যাকাউন্ট ব্যবহার করে সম্পাদিত লেনদেনকে বোঝায়। এই লেনদেনগুলোর জন্য গুগল কোনো চার্জ আরোপ করবে না।

এককালীন বাহ্যিক লেনদেন

এটি একটি এককালীন লেনদেন।

JSON উপস্থাপনা 
{
  "externalTransactionToken": string
}
ক্ষেত্র
externalTransactionToken

string

শুধুমাত্র ইনপুট। 'তৈরি করুন' (Create) কল করার সময় এটি প্রদান করা হয়। বিকল্প বিলিং ফ্লো চালু করা হলে ক্লায়েন্টের কাছ থেকে এটি সংগ্রহ করা হয়।

পুনরাবৃত্ত বাহ্যিক লেনদেন

এটি এমন একটি লেনদেনকে বোঝায় যা পর্যায়ক্রমিক অর্থপ্রদানের একটি সিরিজের অংশ। এটি একটি সাবস্ক্রিপশন বা একাধিক অর্থপ্রদান সহ একটি এককালীন পণ্য (যেমন প্রি-অর্ডার) হতে পারে।

JSON উপস্থাপনা 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
ক্ষেত্র
নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
initialExternalTransactionId

string

এই পুনরাবৃত্তিমূলক লেনদেন সিরিজের প্রথম লেনদেনটির বাহ্যিক লেনদেন আইডি। উদাহরণস্বরূপ, একটি সাবস্ক্রিপশনের ক্ষেত্রে এটি হবে প্রথম পেমেন্টের লেনদেন আইডি। পুনরাবৃত্তিমূলক বাহ্যিক লেনদেন তৈরি করার সময় এটি আবশ্যক।

externalTransactionToken

string

শুধুমাত্র ইনপুট। 'তৈরি করুন' (Create) কলের সময় প্রদান করতে হবে। বিকল্প বিলিং প্রক্রিয়া চালু করা হলে ক্লায়েন্টের কাছ থেকে সংগ্রহ করতে হবে। শুধুমাত্র প্রাথমিক ক্রয়ের জন্য প্রয়োজন।

migratedTransactionProgram

enum ( ExternalTransactionProgram )

শুধুমাত্র ইনপুট। 'তৈরি করুন' (Create) কল করার সময় এটি প্রদান করতে হবে। কোনো সাবস্ক্রিপশনকে ম্যানুয়াল মাসিক রিপোর্টিং থেকে স্বয়ংক্রিয় রিপোর্টিং-এ স্থানান্তরিত করার সময় এটি অবশ্যই ব্যবহার করতে হবে।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।
প্রয়োজনীয়। পুনরাবৃত্তিমূলক বাহ্যিক লেনদেনে পণ্যের বিবরণ। নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
externalSubscription

object ( ExternalSubscription )

একটি বাহ্যিক সাবস্ক্রিপশনের বিবরণ।

otherRecurringProduct

object ( OtherRecurringProduct )

একটি পুনরাবৃত্তিমূলক বাহ্যিক লেনদেন পণ্যের বিবরণ যা অন্য কোনো নির্দিষ্ট বিভাগের অন্তর্ভুক্ত নয়।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

বাহ্যিক লেনদেন প্রোগ্রাম

এটি সেই বাহ্যিক লেনদেন প্রোগ্রামকে বোঝায় যা ব্যবহারকারী লেনদেনটি সম্পন্ন করার জন্য ব্যবহার করেন।

এনাম
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED অনির্দিষ্ট লেনদেন প্রোগ্রাম। ব্যবহৃত হয়নি।
USER_CHOICE_BILLING ব্যবহারকারীর পছন্দের বিলিং, যেখানে একজন ব্যবহারকারী গুগল প্লে বিলিং এবং ডেভেলপার-পরিচালিত বিলিং-এর মধ্যে যেকোনো একটি বেছে নিতে পারেন।
ALTERNATIVE_BILLING_ONLY শুধুমাত্র বিকল্প বিলিং, যেখানে ব্যবহারকারীরা কেবল ডেভেলপার-ম্যানেজার বিলিং ব্যবহার করতে পারবেন।

বাহ্যিক সাবস্ক্রিপশন

একটি বাহ্যিক সাবস্ক্রিপশনের বিবরণ।

JSON উপস্থাপনা 
{
  "subscriptionType": enum (SubscriptionType)
}
ক্ষেত্র
subscriptionType

enum ( SubscriptionType )

আবশ্যক। বাহ্যিক সাবস্ক্রিপশনের ধরণ।

সাবস্ক্রিপশন টাইপ

বাহ্যিক সাবস্ক্রিপশনের প্রকারভেদ।

এনাম
SUBSCRIPTION_TYPE_UNSPECIFIED অনির্দিষ্ট, ব্যবহার করবেন না।
RECURRING এটি একটি পুনরাবৃত্তিমূলক সাবস্ক্রিপশন, যেখানে ব্যবহারকারীকে প্রতিটি বিলিং চক্রে চার্জ করা হয়।
PREPAID এটি একটি প্রিপেইড সাবস্ক্রিপশন, যেখানে ব্যবহারকারীকে অগ্রিম অর্থ পরিশোধ করতে হয়।

অন্যান্য পুনরাবৃত্ত পণ্য

এই প্রকারে কোনো ক্ষেত্র নেই।

একটি পুনরাবৃত্তিমূলক বাহ্যিক লেনদেন পণ্যের বিবরণ, যা অন্য কোনো সুনির্দিষ্ট বিভাগের অন্তর্ভুক্ত নয়।

লেনদেন অবস্থা

লেনদেন সম্পন্ন হওয়ার অবস্থা।

এনাম
TRANSACTION_STATE_UNSPECIFIED অনির্দিষ্ট লেনদেনের অবস্থা। ব্যবহৃত নয়।
TRANSACTION_REPORTED লেনদেনটি সফলভাবে গুগলকে জানানো হয়েছে।
TRANSACTION_CANCELED লেনদেনটির সম্পূর্ণ অর্থ ফেরত দেওয়া হয়েছে।

বাহ্যিক লেনদেনের ঠিকানা

বাহ্যিক লেনদেনের জন্য ব্যবহারকারীর ঠিকানা।

JSON উপস্থাপনা 
{
  "regionCode": string,
  "administrativeArea": string
}
ক্ষেত্র
regionCode

string

আবশ্যক। ISO-3166-1 Alpha-2 (জাতিসংঘের অঞ্চল কোড) ভিত্তিক দুই অক্ষরের অঞ্চল কোড।

administrativeArea

string

ঐচ্ছিক। দেশ/অঞ্চলের সর্বোচ্চ স্তরের প্রশাসনিক উপবিভাগ। শুধুমাত্র ভারতে লেনদেনের জন্য প্রয়োজন। বৈধ মানগুলি হল "আন্দামান এবং নিকোবর দ্বীপপুঞ্জ", "অন্ধ্র প্রদেশ", "অরুণাচল প্রদেশ", "আসাম", "বিহার", "চণ্ডীগড়", "ছত্তিসগড়", "দাদরা এবং নগর হাভেলি", "দাদ্রা এবং নগর হাভেলি", "দাদরা এবং নগর হাভেলি", "আন্দামান্দি" "দিল্লি", "গোয়া", "গুজরাট", "হরিয়ানা", "হিমাচল প্রদেশ", "জম্মু ও কাশ্মীর", "ঝাড়খন্ড", "কর্নাটক", "কেরালা", "লাদাখ", "লক্ষদ্বীপ", "মধ্যপ্রদেশ", "মহারাষ্ট্রমণিপুর", "মহারাষ্ট্রমণি" "নাগাল্যান্ড", "ওডিশা", "পুদুচেরি", "পাঞ্জাব", "রাজস্থান", "সিকিম", "তামিলনাড়ু", "তেলাঙ্গানা", "ত্রিপুরা", "উত্তর প্রদেশ", "উত্তরাখন্ড" এবং "পশ্চিমবঙ্গ"।

বাহ্যিক অফারের বিবরণ

বাহ্যিক অফার প্রোগ্রামের জন্য স্বতন্ত্র রিপোর্টিং বিবরণ।

JSON উপস্থাপনা 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
ক্ষেত্র
installedAppPackage

string

ঐচ্ছিক। এই লেনদেনের মাধ্যমে ডাউনলোড করা অ্যাপটির প্যাকেজ নাম। যখন linkType-এর মান LINK_TO_APP_DOWNLOAD হয়, তখন এটি আবশ্যক।

installedAppCategory

enum ( ExternalOfferAppCategory )

ঐচ্ছিক। এই লেনদেনের মাধ্যমে ডাউনলোড করা অ্যাপের ক্যাটাগরি। এটি অবশ্যই প্লে কনসোলে বাহ্যিক অ্যাপ যাচাইকরণ প্রক্রিয়ার সময় প্রদত্ত ক্যাটাগরির সাথে মিলতে হবে। শুধুমাত্র অ্যাপ ডাউনলোডের জন্য আবশ্যক।

appDownloadEventExternalTransactionId

string

ঐচ্ছিক। বাহ্যিক লিঙ্কের মাধ্যমে অ্যাপ ডাউনলোড ইভেন্টের সাথে যুক্ত বাহ্যিক লেনদেন আইডি। বাহ্যিকভাবে ইনস্টল করা অ্যাপে করা লেনদেন রিপোর্ট করার সময় এটি আবশ্যক।

এক্সটার্নাল অফার লিঙ্ক টাইপ

বাহ্যিক লিঙ্কের ধরণ।

এনাম
LINK_TO_DIGITAL_CONTENT_OFFER ডিজিটাল কন্টেন্ট কেনার একটি প্রস্তাব।

এক্সটার্নালঅফারঅ্যাপক্যাটাগরি

ডাউনলোড করা অ্যাপের ক্যাটাগরি। অ্যাপের ক্যাটাগরি সম্পর্কে আরও তথ্যের জন্য https://support.google.com/googleplay/android-developer/answer/9859673 দেখুন।

এনাম
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED অনির্দিষ্ট, ব্যবহার করবেন না।
APP অ্যাপটি অ্যাপ বিভাগের অধীনে শ্রেণীবদ্ধ করা হয়েছে।
GAME অ্যাপটি গেম ক্যাটাগরির অধীনে শ্রেণীবদ্ধ করা হয়েছে।

বাহ্যিক বিষয়বস্তু লিঙ্কের বিবরণ

বাহ্যিক কন্টেন্ট লিঙ্ক প্রোগ্রামের জন্য স্বতন্ত্র রিপোর্টিং বিবরণ।

JSON উপস্থাপনা 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
ক্ষেত্র
installedAppPackage

string

ঐচ্ছিক। এই লেনদেনের মাধ্যমে ডাউনলোড করা অ্যাপটির প্যাকেজ নাম। শুধুমাত্র অ্যাপ ইনস্টলের জন্য প্রয়োজন।

externalAppCategory

enum ( ExternalContentAppCategory )

ঐচ্ছিক। ডাউনলোড করা অ্যাপের ক্যাটাগরি। বাহ্যিক অ্যাপ যাচাইকরণ প্রক্রিয়ার সময় প্লে কনসোলে প্রদত্ত ক্যাটাগরির সাথে এটি অবশ্যই মিলতে হবে। শুধুমাত্র অ্যাপ ইনস্টলের জন্য প্রয়োজন।

এক্সটার্নাল কন্টেন্ট লিঙ্ক টাইপ

বাহ্যিক লিঙ্কের ধরণ।

এনাম
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED অনির্দিষ্ট, ব্যবহার করবেন না।
LINK_TO_DIGITAL_CONTENT_OFFER ডিজিটাল কন্টেন্ট কেনার একটি প্রস্তাব।

এক্সটার্নালকন্টেন্টঅ্যাপক্যাটাগরি

ডাউনলোড করা অ্যাপের ক্যাটাগরি। অ্যাপের ক্যাটাগরি সম্পর্কে আরও তথ্যের জন্য https://support.google.com/googleplay/android-developer/answer/9859673 দেখুন।

এনাম
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED অনির্দিষ্ট, ব্যবহার করবেন না।
APP অ্যাপটি অ্যাপ বিভাগের অধীনে শ্রেণীবদ্ধ করা হয়েছে।
GAME অ্যাপটি গেম ক্যাটাগরির অধীনে শ্রেণীবদ্ধ করা হয়েছে।

পদ্ধতি

createexternaltransaction

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

getexternaltransaction

 একটি বিদ্যমান বাহ্যিক লেনদেন পায়।

refundexternaltransaction

 বিদ্যমান কোনো বাহ্যিক লেনদেনের সম্পূর্ণ বা আংশিক অর্থ ফেরত দেয়।

ত্রুটি কোড

এই রিসোর্সের কার্যক্রম নিম্নলিখিত HTTP ত্রুটি কোডগুলি প্রদান করে:

ত্রুটি কোড কারণ বর্ণনা সমাধান