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

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

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

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

गड़बड़ी का कोड कारण रिज़ॉल्यूशन
5xx Google Play सर्वर में सामान्य गड़बड़ी. अनुरोध को फिर से भेजें.

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

किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे पहले से ही अपडेट किया जा रहा है. उदाहरण के लिए, Play Billing Library के acknowledgePurchase() तरीके को कॉल करके और Play Developer API के purchases.products.acknowledge को एक साथ कॉल करके, खरीदारी की पुष्टि की जा रही है.

 अनुरोध को फिर से भेजें.