REST Resource: purchases.products

संसाधन: ProductPurchase

ProductPurchase संसाधन से, ऐप्लिकेशन में खरीदार के प्रॉडक्ट खरीदने की स्थिति के बारे में पता चलता है.

JSON के काेड में दिखाना
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
फ़ील्ड
kind

string

यह तरह, androidpublisher सेवा में inappPurchase ऑब्जेक्ट को दिखाती है.

purchaseTimeMillis

string (int64 format)

प्रॉडक्ट खरीदने का समय. इसे 1 जनवरी, 1970 से मिलीसेकंड में दिखाया जाता है.

purchaseState

integer

ऑर्डर की खरीदारी की स्थिति. इसकी वैल्यू 0 हो सकती है. खरीदा गया 1. रद्द किया गया 2. मंज़ूरी बाकी है

consumptionState

integer

ऐप्लिकेशन में मौजूद प्रॉडक्ट के इस्तेमाल की स्थिति. इसकी वैल्यू 0 हो सकती है. अभी तक इस्तेमाल नहीं किया गया 1. उपभोग किया

developerPayload

string

डेवलपर की ओर से तय की गई ऐसी स्ट्रिंग जिसमें किसी ऑर्डर के बारे में अतिरिक्त जानकारी होती है.

orderId

string

इन-ऐप्लिकेशन प्रॉडक्ट की खरीदारी से जुड़ा ऑर्डर आईडी.

purchaseType

integer

इन-ऐप प्रॉडक्ट की खरीदारी का टाइप. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब यह खरीदारी, ऐप्लिकेशन में खरीदारी के लिए उपलब्ध स्टैंडर्ड बिलिंग सिस्टम का इस्तेमाल करके नहीं की गई हो. इसकी वैल्यू 0 हो सकती है. टेस्ट (यानी कि लाइसेंस टेस्टिंग खाते से खरीदा गया) 1. प्रमोशन (यानी कि प्रोमो कोड का इस्तेमाल करके खरीदा गया). इसमें Play Points से की गई खरीदारी शामिल नहीं है. 2. इनाम के तौर पर (यानी कि पैसे चुकाने के बजाय वीडियो विज्ञापन देखने पर)

acknowledgementState

integer

ऐप्लिकेशन में मौजूद प्रॉडक्ट के लिए, पुष्टि की स्थिति. इसकी वैल्यू 0 हो सकती है. अभी तक स्वीकार नहीं किया गया 1. स्वीकृत

purchaseToken

string

इस खरीदारी की पहचान करने के लिए जनरेट किया गया परचेज़ टोकन. ऐसा हो सकता है कि यह मौजूद न हो.

productId

string

ऐप्लिकेशन में मौजूद प्रॉडक्ट का एसकेयू. ऐसा हो सकता है कि यह मौजूद न हो.

quantity

integer

इन-ऐप्लिकेशन प्रॉडक्ट की खरीदारी से जुड़ी संख्या. अगर यह मौजूद नहीं है, तो संख्या 1 होती है.

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

प्रॉडक्ट का ऐक्सेस दिए जाने के समय, उपयोगकर्ता के बिलिंग क्षेत्र का ISO 3166-1 ऐल्फ़ा-2 कोड.

refundableQuantity

integer

रिफ़ंड के लिए मान्य मात्रा, यानी कि वह मात्रा जिसका रिफ़ंड नहीं किया गया है. इस वैल्यू में, संख्या के आधार पर दिए गए आंशिक रिफ़ंड और पूरे रिफ़ंड शामिल होते हैं.

तरीके

acknowledge

यह कुकी, ऐप्लिकेशन में मौजूद किसी आइटम की खरीदारी की पुष्टि करती है.

consume

यह कुकी, ऐप्लिकेशन में मौजूद किसी आइटम की खरीदारी की जानकारी को सेव करती है.

get

यह कुकी, ऐप्लिकेशन में मौजूद किसी आइटम की खरीदारी और उसके इस्तेमाल की स्थिति की जांच करती है.

गड़बड़ी के कोड

इस संसाधन के ऑपरेशन, यहां दिए गए एचटीटीपी गड़बड़ी कोड दिखाते हैं:

गड़बड़ी का कोड कारण ब्यौरा रिज़ॉल्यूशन
400 invalidPurchaseState खरीदारी की स्थिति ऐसी नहीं है कि अनुरोध की गई कार्रवाई की जा सके. उदाहरण के लिए, ऐसा हो सकता है कि आपने पहले ही इस्तेमाल की जा चुकी खरीदारी की पुष्टि करने की कोशिश की हो या ऐसी सदस्यता रद्द करने की कोशिश की हो जो चालू नहीं है. कार्रवाई करने से पहले, Get API का इस्तेमाल करके संसाधन की मौजूदा स्थिति देखें. पक्का करें कि कार्रवाई के लिए संसाधन सही स्थिति में हो.
400 invalidValue अनुरोध में अमान्य वैल्यू दी गई है. आम तौर पर, यह गड़बड़ी तब दिखती है, जब खरीदारी का टोकन गलत हो या मान्य न हो. एपीआई के रेफ़रंस के आधार पर, अनुरोध के मुख्य हिस्से या पैरामीटर में मौजूद फ़ील्ड की अमान्य वैल्यू को ठीक करें.
400 productNotOwnedByUser खरीदारी के लिए दिया गया टोकन मान्य है, लेकिन फ़िलहाल उपयोगकर्ता के पास यह प्रॉडक्ट नहीं है. ऐसा तब हो सकता है, जब खरीदारी की पुष्टि करने से पहले ही उसे रिफ़ंड कर दिया गया हो, रद्द कर दिया गया हो या उसकी समयसीमा खत्म हो गई हो. कार्रवाई करने से पहले, Get API का इस्तेमाल करके संसाधन की मौजूदा स्थिति देखें. पक्का करें कि कार्रवाई के लिए संसाधन सही स्थिति में हो.
400 purchaseTokenMismatch खरीदारी के लिए दिया गया टोकन, खरीदारी, पैकेज के नाम, सदस्यता आईडी या प्रॉडक्ट आईडी से मेल नहीं खाता. पुष्टि करें कि अनुरोध में दी गई सभी जानकारी सही है और एक-दूसरे से मेल खाती है.
400 required अनुरोध में कोई ज़रूरी फ़ील्ड या पैरामीटर मौजूद नहीं है. एपीआई के दस्तावेज़ देखें और पक्का करें कि सभी ज़रूरी फ़ील्ड और पैरामीटर शामिल किए गए हों.
400 unsupportedIabType दिए गए इन-ऐप्लिकेशन बिलिंग टाइप के लिए, यह कार्रवाई नहीं की जा सकती. पक्का करें कि एपीआई का तरीका, मैनेज किए जा रहे आइटम टाइप के साथ काम करता हो.
403 userInsufficientPermission अनुरोध की गई कार्रवाई को पूरा करने के लिए, उपयोगकर्ता के पास ज़रूरी अनुमति नहीं है. पक्का करें कि पुष्टि किए गए उपयोगकर्ता के पास, Google Play Console में ज़रूरी अनुमतियां हों. ज़्यादा जानकारी के लिए, सेवा खाते का इस्तेमाल करना लेख पढ़ें.
404 notFound अनुरोध किया गया संसाधन नहीं मिला. पुष्टि करें कि आइडेंटिफ़ायर (जैसे, खरीदारी का टोकन, पैकेज का नाम, प्रॉडक्ट आईडी, सदस्यता आईडी) सही हैं.
409 concurrentUpdate किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे एक साथ अपडेट किया जा रहा है. एक्स्पोनेंशियल बैकऑफ़ के साथ अनुरोध को फिर से भेजें. एक ही संसाधन में एक साथ कई बदलाव न करें.
5xx Generic error Google Play सर्वर में सामान्य गड़बड़ी. अनुरोध को फिर से भेजें.

अगर समस्या बनी रहती है, तो अपने Google Play खाता मैनेजर से संपर्क करें या सहायता का अनुरोध सबमिट करें. अगर आपको किसी रुकावट के बारे में पहले से पता है, तो Play स्टेटस डैशबोर्ड देखें.