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,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.

  // Union field program_details can be only one of the following:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  }
  // End of list of possible types for union field program_details.
}
ক্ষেত্র
packageName

string

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

externalTransactionId

string

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

originalPreTaxAmount

object ( Price )

প্রয়োজনীয়। করের আগে লেনদেনের মূল পরিমাণ। এটি কোনও ফেরত প্রয়োগের আগে Google-কে মূলত জানানো ট্যাক্স-পূর্ব পরিমাণকে প্রতিনিধিত্ব করে।

originalTaxAmount

object ( Price )

প্রয়োজনীয়। মূল করের পরিমাণ। এটি কোনও ফেরত দেওয়ার আগে Google-কে মূলত জানানো ট্যাক্সের পরিমাণকে প্রতিনিধিত্ব করে।

currentPreTaxAmount

object ( Price )

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

currentTaxAmount

object ( Price )

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

testPurchase

object ( ExternalTransactionTestPurchase )

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

transactionTime

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

createTime

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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-এর সাথে যোগাযোগ করুন। দ্রষ্টব্য: এই ক্ষেত্রটি বহিরাগত অফার লেনদেনের জন্য ব্যবহার করা যাবে না।

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

object ( OneTimeExternalTransaction )

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

recurringTransaction

object ( RecurringExternalTransaction )

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

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

object ( ExternalOfferDetails )

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

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

এই ধরণের কোনও ক্ষেত্র নেই।

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

ওয়ানটাইম এক্সটার্নাল লেনদেন

এককালীন লেনদেনের প্রতিনিধিত্ব করে।

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

string

শুধুমাত্র ইনপুট। Create-এ কল করার সময় প্রদান করা হয়েছে। বিকল্প বিলিং প্রবাহ চালু হওয়ার সময় ক্লায়েন্ট থেকে প্রাপ্ত।

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

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

JSON উপস্থাপনা 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের source ।

source নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

initialExternalTransactionId

string

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

externalTransactionToken

string

শুধুমাত্র ইনপুট। Create-এ কল করার সময় প্রদান করা হয়েছে। বিকল্প বিলিং প্রবাহ চালু হওয়ার সময় ক্লায়েন্ট থেকে প্রাপ্ত। শুধুমাত্র প্রাথমিক ক্রয়ের জন্য প্রয়োজনীয়।

migratedTransactionProgram

enum ( ExternalTransactionProgram )

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

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

object ( ExternalSubscription )

বহিরাগত সাবস্ক্রিপশনের বিবরণ।

otherRecurringProduct

object ( OtherRecurringProduct )

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

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

লেনদেন সম্পন্ন করার জন্য ব্যবহারকারীর দ্বারা অভিজ্ঞ বহিরাগত লেনদেন প্রোগ্রামের প্রতিনিধিত্ব করে।

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

বহিরাগত সাবস্ক্রিপশন

বহিরাগত সাবস্ক্রিপশনের বিবরণ।

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

enum ( SubscriptionType )

প্রয়োজনীয়। বহিরাগত সাবস্ক্রিপশনের ধরণ।

সাবস্ক্রিপশনের ধরণ

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

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

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

এই ধরণের কোনও ক্ষেত্র নেই।

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

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

একটি লেনদেনের অবস্থা।

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

বহিরাগত লেনদেন ঠিকানা

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

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

string

প্রয়োজনীয়। ISO-3166-1 Alpha-2 (UN অঞ্চল কোড) এর উপর ভিত্তি করে দুই অক্ষরের অঞ্চল কোড।

administrativeArea

string

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

বাহ্যিক অফারবিস্তারিত

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

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

string

ঐচ্ছিক। এই লেনদেনের মাধ্যমে ডাউনলোড করা অ্যাপের প্যাকেজের নাম। linkType LINK_TO_APP_DOWNLOAD হলে প্রয়োজন।

installedAppCategory

enum ( ExternalOfferAppCategory )

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

appDownloadEventExternalTransactionId

string

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

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

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

এনামস
LINK_TO_DIGITAL_CONTENT_OFFER ডিজিটাল কন্টেন্ট কেনার অফার।

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

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

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

পদ্ধতি

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

 একটি বিদ্যমান বহিরাগত লেনদেনের অর্থ ফেরত বা আংশিকভাবে ফেরত দেয়।

ত্রুটি কোড

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

ত্রুটি কোড কারণ রেজোলিউশন
5xx গুগল প্লে সার্ভারে সাধারণ ত্রুটি। আপনার অনুরোধটি আবার চেষ্টা করুন।

যদি সমস্যাটি থেকে যায়, তাহলে আপনার Google Play অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন অথবা একটি সহায়তা অনুরোধ জমা দিন। কোনও পরিচিত বিভ্রাটের জন্য Play Status Dashboard চেক করার কথা বিবেচনা করুন।

409 কনকারেন্সি আপডেট ত্রুটি।

একটি অবজেক্ট আপডেট করার চেষ্টা করা হয়েছিল যা আপডেট করা হচ্ছে। উদাহরণস্বরূপ, Play Billing Library এর acknowledgePurchase() পদ্ধতিতে কল করে এবং Play Developer API এর purchases.products.acknowledge একই সময়ে কল করে একটি ক্রয়ের স্বীকৃতি পাওয়া যাচ্ছে।

 আপনার অনুরোধটি আবার চেষ্টা করুন।