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 alpha-2 कोड.
purchaseCompletionTime

string (Timestamp format)

खरीदारी पूरी होने का समय. इसका मतलब है कि जब PurchaseState का स्टेटस 'खरीदारी पूरी हुई' में बदला. पेमेंट पूरा होने तक यह फ़ील्ड नहीं दिखेगा. उदाहरण के लिए, अगर उपयोगकर्ता ने कोई ऐसा लेन-देन शुरू किया है जो अभी तक पूरा नहीं हुआ है (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)

टेस्ट खरीदारी का फ़ॉप टाइप.

FopType

फ़ाइल फ़ॉर्मैट के संभावित टाइप.

Enums
FOP_TYPE_UNSPECIFIED फ़ाइल फ़ॉर्मैट का टाइप नहीं बताया गया है. इस वैल्यू को कभी सेट नहीं किया जाना चाहिए.
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

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