REST Resource: purchases.productsv2

संसाधन: ProductPurchaseV2

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

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

string (Timestamp format)

वह समय जब खरीदारी पूरी हुई थी. यानी, जब PurchaseState बदलकर PURCHASED हो गया था. पेमेंट पूरा होने तक यह फ़ील्ड मौजूद नहीं होगा. उदाहरण के लिए, अगर उपयोगकर्ता ने कोई ऐसा लेन-देन शुरू किया है जो अभी पूरा नहीं हुआ है https://developer.android.com/google/play/billing/integrate#pending), तो यह फ़ील्ड तब तक नहीं भरा जाएगा, जब तक उपयोगकर्ता लेन-देन पूरा करने के लिए ज़रूरी चरणों को पूरा नहीं कर लेता.

यह आरएफ़सी 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".
acknowledgementState

enum (AcknowledgementState)

सिर्फ़ आउटपुट के लिए. खरीदारी की पुष्टि करने की स्थिति.

PurchaseStateContext

खरीदारी की स्थिति के बारे में कॉन्टेक्स्ट.

JSON के काेड में दिखाना 
{
  "purchaseState": enum (PurchaseState)
}
फ़ील्ड
purchaseState

enum (PurchaseState)

सिर्फ़ आउटपुट के लिए. खरीदारी की स्थिति.

PurchaseState

खरीदारी की संभावित स्थितियां.

Enums
PURCHASE_STATE_UNSPECIFIED खरीदारी की स्थिति की जानकारी नहीं दी गई है. इस वैल्यू को कभी भी सेट नहीं किया जाना चाहिए.
PURCHASED खरीदारी पूरी हुई.
CANCELLED खरीदारी रद्द की गई.
PENDING खरीदारी अधूरी है और अभी तक पूरी नहीं हुई है. लंबित खरीदारी को मैनेज करने के बारे में ज़्यादा जानने के लिए, https://developer.android.com/google/play/billing/integrate#pending पर जाएं.

TestPurchaseContext

टेस्ट के तौर पर की गई खरीदारी के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "fopType": enum (FopType)
}
फ़ील्ड
fopType

enum (FopType)

टेस्ट परचेज़ का FOP टाइप.

FopType

एफ़ओपी के संभावित टाइप.

Enums
FOP_TYPE_UNSPECIFIED Fop टाइप की जानकारी नहीं दी गई है. इस वैल्यू को कभी भी सेट नहीं किया जाना चाहिए.
TEST खरीदारी, टेस्ट कार्ड का इस्तेमाल करके की गई थी.

ProductLineItem

इसमें ProductPurchaseV2 के लिए, सामान के लेवल की जानकारी होती है.

JSON के काेड में दिखाना 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
फ़ील्ड
productId

string

खरीदे गए प्रॉडक्ट का आईडी. उदाहरण के लिए, 'monthly001'.
productOfferDetails

object (ProductOfferDetails)

इस आइटम के लिए ऑफ़र की जानकारी.

ProductOfferDetails

ऑफ़र की जानकारी, खरीदारी के लाइन आइटम से जुड़ी होती है.

JSON के काेड में दिखाना 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
फ़ील्ड
offerTags[]

string

ऑफ़र से जुड़े नए ऑफ़र टैग. इसमें खरीदारी के विकल्प से इनहेरिट किए गए टैग शामिल होते हैं.
offerId

string

ऑफ़र आईडी. यह सिर्फ़ ऑफ़र के लिए मौजूद होता है.
purchaseOptionId

string

खरीदारी के विकल्प का आईडी.
rentOfferDetails

object (RentOfferDetails)

किराये के ऑफ़र के बारे में जानकारी. इसे सिर्फ़ किराये के लाइन आइटम के लिए सेट किया जाएगा.
offerToken

string

इस खरीदारी के लाइन आइटम के लिए इस्तेमाल किया गया, हर लेन-देन के हिसाब से ऑफ़र टोकन.
quantity

integer

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

integer

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

enum (ConsumptionState)

सिर्फ़ आउटपुट के लिए. खरीदारी के इस्तेमाल की स्थिति.

RentOfferDetails

इस टाइप में कोई फ़ील्ड नहीं है.

किराये पर लिए गए लाइन आइटम से जुड़ी ऑफ़र की जानकारी.

ConsumptionState

इस्तेमाल की जा सकने वाली स्थितियां.

Enums
CONSUMPTION_STATE_UNSPECIFIED इस्तेमाल की स्थिति की जानकारी नहीं दी गई है. इस वैल्यू को कभी भी सेट नहीं किया जाना चाहिए.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED अभी तक इस्तेमाल नहीं किया गया है.
CONSUMPTION_STATE_CONSUMED पहले ही इस्तेमाल किया जा चुका है.

AcknowledgementState

वन टाइम प्रॉडक्ट की पुष्टि की स्थिति.

Enums
ACKNOWLEDGEMENT_STATE_UNSPECIFIED स्वीकार किए जाने की स्थिति के बारे में कोई जानकारी नहीं दी गई है.
ACKNOWLEDGEMENT_STATE_PENDING खरीदारी की पुष्टि अब तक नहीं की गई है.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED खरीदारी स्वीकार कर ली गई है.

तरीके

getproductpurchasev2

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

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

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

गड़बड़ी का कोड कारण ब्यौरा रिज़ॉल्यूशन
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 का स्टेटस डैशबोर्ड देखें.