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.
}
ক্ষেত্র
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)

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

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-এর সাথে যোগাযোগ করুন। দ্রষ্টব্য: এই ক্ষেত্রটি বাহ্যিক অফার লেনদেনের জন্য ব্যবহার করা যাবে না।

ইউনিয়ন ক্ষেত্র transaction_type । যে ধরনের লেনদেন সম্পাদিত হয়েছিল। transaction_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
oneTimeTransaction

object ( OneTimeExternalTransaction )

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

recurringTransaction

object ( RecurringExternalTransaction )

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

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

এই ধরনের কোন ক্ষেত্র নেই.

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

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

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

JSON প্রতিনিধিত্ব 
{
  "externalTransactionToken": string
}
ক্ষেত্র
externalTransactionToken

string

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

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

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

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

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

migratedTransactionProgram

enum ( ExternalTransactionProgram )

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

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

object ( ExternalSubscription )

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

otherRecurringProduct

object ( OtherRecurringProduct )

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

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

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

এনামস
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED অনির্দিষ্ট লেনদেন প্রোগ্রাম। ব্যবহার করা হয়নি।
USER_CHOICE_BILLING ব্যবহারকারীর পছন্দের বিলিং, যেখানে একজন ব্যবহারকারী Google Play বিলিং ডেভেলপার-পরিচালিত বিলিং থেকে বেছে নিতে পারেন।
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 আলফা-2 (UN অঞ্চল কোড) এর উপর ভিত্তি করে দুটি অক্ষরের অঞ্চল কোড।

administrativeArea

string

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

পদ্ধতি

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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