REST Resource: purchases.productsv2

উৎস: প্রোডাক্টপারচেজভি২

ProductPurchaseV2 রিসোর্সটি একজন ব্যবহারকারীর অ্যাপের মধ্যে পণ্য ক্রয়ের অবস্থা নির্দেশ করে।

JSON উপস্থাপনা 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
ক্ষেত্র
productLineItem[]

object ( ProductLineItem )

ProductPurchaseV2-এর জন্য আইটেম-স্তরের তথ্য ধারণ করে।

kind

string

এই প্রকারটি androidpublisher সার্ভিসে থাকা একটি ProductPurchaseV2 অবজেক্টকে প্রতিনিধিত্ব করে।

purchaseStateContext

object ( PurchaseStateContext )

ক্রয়ের অবস্থা সম্পর্কিত তথ্য।

testPurchaseContext

object ( TestPurchaseContext )

পরীক্ষামূলক ক্রয় সংক্রান্ত তথ্য। এটি শুধুমাত্র পরীক্ষামূলক ক্রয়ের জন্য সেট করা হবে।

orderId

string

ইন-অ্যাপ প্রোডাক্ট ক্রয়ের সাথে যুক্ত অর্ডার আইডি। ক্রয়ের সাথে কোনো অর্ডার যুক্ত না থাকলে এটি সেট নাও হতে পারে।

obfuscatedExternalAccountId

string

আইডি-র একটি অস্পষ্ট সংস্করণ যা আপনার অ্যাপে ব্যবহারকারীর অ্যাকাউন্টের সাথে অনন্যভাবে যুক্ত। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন ক্রয় করার সময় https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid ব্যবহার করে এটি নির্দিষ্ট করা হয়।

obfuscatedExternalProfileId

string

আইডি-র একটি অস্পষ্ট সংস্করণ যা আপনার অ্যাপে ব্যবহারকারীর প্রোফাইলের সাথে অনন্যভাবে যুক্ত থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে, যদি ক্রয় করার সময় https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid ব্যবহার করে এটি নির্দিষ্ট করা হয়।

regionCode

string

পণ্যটি মঞ্জুর করার সময় ব্যবহারকারীর আইএসও ৩১৬৬-১ আলফা-২ বিলিং অঞ্চল কোড।

purchaseCompletionTime

string ( Timestamp format)

যে সময়ে ক্রয় সফল হয়েছে, অর্থাৎ যখন PurchaseState পরিবর্তিত হয়ে PURCHASED হয়েছে। পেমেন্ট সম্পূর্ণ না হওয়া পর্যন্ত এই ফিল্ডটি উপস্থিত থাকবে না। উদাহরণস্বরূপ, যদি ব্যবহারকারী একটি পেন্ডিং ট্রানজ্যাকশন ( https://developer.android.com/google/play/billing/integrate#pending) শুরু করেন, তাহলে ট্রানজ্যাকশনটি সম্পন্ন করার জন্য প্রয়োজনীয় ধাপগুলো সফলভাবে শেষ না করা পর্যন্ত এই ফিল্ডটি পূরণ হবে না।

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

acknowledgementState

enum ( AcknowledgementState )

শুধুমাত্র আউটপুট। ক্রয়ের স্বীকৃতি অবস্থা।

ক্রয় অবস্থা প্রসঙ্গ

ক্রয়ের অবস্থা সম্পর্কিত প্রেক্ষাপট।

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

enum ( PurchaseState )

শুধুমাত্র আউটপুট। ক্রয়ের অবস্থা।

ক্রয়রাজ্য

সম্ভাব্য ক্রয়ের অবস্থা।

এনাম
PURCHASE_STATE_UNSPECIFIED ক্রয়ের অবস্থা অনির্দিষ্ট। এই মানটি কখনোই সেট করা উচিত নয়।
PURCHASED সফলভাবে ক্রয় করা হয়েছে।
CANCELLED ক্রয় বাতিল করা হয়েছে।
PENDING ক্রয়টি অপেক্ষমান অবস্থায় আছে এবং এখনও সম্পন্ন হয়নি। অপেক্ষমান ক্রয় পরিচালনা সম্পর্কে আরও তথ্যের জন্য, https://developer.android.com/google/play/billing/integrate#pending দেখুন।

টেস্টপারচেজকনটেক্সট

পরীক্ষামূলক ক্রয় সংক্রান্ত প্রেক্ষাপট।

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

enum ( FopType )

পরীক্ষামূলক ক্রয়ের ফপ টাইপ।

FopType

সম্ভাব্য ফপ প্রকারভেদ।

এনাম
FOP_TYPE_UNSPECIFIED Fop-এর ধরণ অনির্দিষ্ট। এই মানটি কখনোই সেট করা উচিত নয়।
TEST একটি টেস্ট কার্ড ব্যবহার করে ক্রয়টি করা হয়েছিল।

প্রোডাক্টলাইনআইটেম

ProductPurchaseV2-এর জন্য আইটেম-স্তরের তথ্য ধারণ করে।

JSON উপস্থাপনা 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
ক্ষেত্র
productId

string

ক্রয়কৃত পণ্যের আইডি (উদাহরণস্বরূপ, 'monthly001')।

productOfferDetails

object ( ProductOfferDetails )

এই পণ্যটির অফারের বিবরণ।

পণ্যের অফারের বিবরণ

ক্রয়কৃত কোনো আইটেম সম্পর্কিত অফারের বিস্তারিত তথ্য।

JSON উপস্থাপনা 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "preorderOfferDetails": {
    object (PreorderOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
ক্ষেত্র
offerTags[]

string

অফারটির সাথে যুক্ত সর্বশেষ অফার ট্যাগগুলো। এতে ক্রয় বিকল্প থেকে প্রাপ্ত ট্যাগগুলো অন্তর্ভুক্ত রয়েছে।

offerId

string

অফার আইডি। শুধুমাত্র অফারের ক্ষেত্রেই প্রযোজ্য।

purchaseOptionId

string

ক্রয় বিকল্প আইডি।

rentOfferDetails

object ( RentOfferDetails )

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

preorderOfferDetails

object ( PreorderOfferDetails )

প্রি-অর্ডার অফারের বিবরণ। এটি শুধুমাত্র প্রি-অর্ডারের জন্য প্রযোজ্য হবে।

offerToken

string

এই ক্রয় আইটেমটি তৈরি করতে ব্যবহৃত প্রতি-লেনদেন অফার টোকেন।

quantity

integer

ইন-অ্যাপ পণ্যটি ক্রয়ের সাথে সংশ্লিষ্ট পরিমাণ।

refundableQuantity

integer

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

consumptionState

enum ( ConsumptionState )

শুধুমাত্র আউটপুট। ক্রয়ের ব্যবহার অবস্থা।

ভাড়ার অফারের বিবরণ

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

ভাড়ার একটি আইটেম সম্পর্কিত বিস্তারিত তথ্য অফার করুন।

প্রি-অর্ডার অফারের বিবরণ

প্রি-অর্ডার করা একটি আইটেম সম্পর্কিত অফারের বিস্তারিত তথ্য।

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

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" ।

ভোগ অবস্থা

সম্ভাব্য ভোগের অবস্থাসমূহ।

এনাম
CONSUMPTION_STATE_UNSPECIFIED ব্যবহারের অবস্থা অনির্দিষ্ট। এই মানটি কখনোই সেট করা উচিত নয়।
CONSUMPTION_STATE_YET_TO_BE_CONSUMED এখনো খাওয়া হয়নি।
CONSUMPTION_STATE_CONSUMED ইতিমধ্যে খাওয়া হয়ে গেছে।

স্বীকৃতি অবস্থা

এককালীন পণ্যের স্বীকৃতি অবস্থা।

এনাম
ACKNOWLEDGEMENT_STATE_UNSPECIFIED অনির্দিষ্ট স্বীকৃতি অবস্থা।
ACKNOWLEDGEMENT_STATE_PENDING ক্রয়টি এখনও স্বীকার করা হয়নি।
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED ক্রয়টি স্বীকার করা হলো।

পদ্ধতি

getproductpurchasev2

 অ্যাপের ভেতরের কোনো আইটেমের ক্রয় ও ব্যবহারের অবস্থা যাচাই করে।

ত্রুটি কোড

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

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