REST Resource: orders

संसाधन: ऑर्डर

Order संसाधन में, Google Play पर किए गए लेन-देन के बारे में पूरी जानकारी शामिल होती है. इसमें कई एट्रिब्यूट शामिल होते हैं. इनसे ऑर्डर, खरीदे गए प्रॉडक्ट, और ऑर्डर से जुड़े इवेंट के इतिहास के बारे में जानकारी मिलती है.

ऑर्डर एपीआई की मदद से, Google Play के नेटवर्क में मौजूद ऑर्डर डेटा को रीयल-टाइम में ऐक्सेस किया जा सकता है. एक बार और बार-बार होने वाले ऑर्डर, दोनों के लिए ज़्यादा जानकारी और मेटाडेटा वापस पाया जा सकता है. इसमें लेन-देन की जानकारी भी शामिल है. जैसे, शुल्क, टैक्स, और रिफ़ंड. साथ ही, इसमें मेटाडेटा भी शामिल है. जैसे, सदस्यता के लिए कीमत के चरण. Orders API की मदद से, ऑर्डर मैनेजमेंट से जुड़े टास्क अपने-आप पूरे किए जा सकते हैं. इससे Play Console में मैन्युअल तरीके से जांच करने की ज़रूरत कम हो जाती है.

इस एपीआई के इस्तेमाल के कुछ उदाहरण यहां दिए गए हैं:

  • रीयल-टाइम में ऑर्डर का डेटा वापस पाना - orders.get की मदद से, ऑर्डर आईडी का इस्तेमाल करके खरीदारी के तुरंत बाद ऑर्डर की जानकारी और मेटाडेटा वापस पाएं.

  • ऑर्डर के अपडेट को सिंक करना - ऑर्डर की जानकारी का अप-टू-डेट रिकॉर्ड बनाए रखने के लिए, ऑर्डर के अपडेट को समय-समय पर सिंक करें.

ध्यान दें:

  • Orders API के कॉल, Play Developer API के आपके कोटा में गिने जाते हैं. यह कोटा डिफ़ॉल्ट रूप से हर दिन 2 लाख होता है. हालांकि, ऑर्डर के लंबे इतिहास को सिंक करने के लिए यह कोटा काफ़ी नहीं हो सकता.

  • हर कॉल में ज़्यादा से ज़्यादा 1,000 ऑर्डर वापस पाए जा सकते हैं. कोटे का इस्तेमाल कम करने के लिए, बड़े पेज साइज़ का इस्तेमाल करने का सुझाव दिया जाता है. Cloud Console में अपना कोटा देखें. अगर आपको इससे ज़्यादा की ज़रूरत है, तो कोटा बढ़ाने का अनुरोध करें.

JSON के काेड में दिखाना 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ],
  "orderId": string,
  "purchaseToken": string,
  "state": enum (State),
  "createTime": string,
  "lastEventTime": string,
  "buyerAddress": {
    object (BuyerAddress)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },
  "orderDetails": {
    object (OrderDetails)
  },
  "orderHistory": {
    object (OrderHistory)
  },
  "developerRevenueInBuyerCurrency": {
    object (Money)
  },
  "pointsDetails": {
    object (PointsDetails)
  },
   "salesChannel": enum (SalesChannel)
}
फ़ील्ड
lineItems[]

object (LineItem)

इस ऑर्डर में शामिल अलग-अलग लाइन आइटम.
orderId

string

ऑर्डर आईडी.
purchaseToken

string

यह टोकन, उपयोगकर्ता के डिवाइस को तब दिया जाता है, जब सदस्यता या आइटम खरीदा जाता है.
state

enum (State)

ऑर्डर की स्थिति.
createTime

string (Timestamp format)

ऑर्डर किए जाने का समय.

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

string (Timestamp format)

ऑर्डर पर हुए आखिरी इवेंट का समय.

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

object (BuyerAddress)

टैक्स का हिसाब लगाने के लिए, ग्राहक के पते की जानकारी. जब Google, ऑर्डर के लिए मर्चेंट ऑफ़ रिकॉर्ड होता है, तब सिर्फ़ देश का नाम दिखता है.
total

object (Money)

कुल रकम जो खरीदार ने दी. इसमें छूट और टैक्स शामिल हैं.
tax

object (Money)

इस ऑर्डर के लिए चुकाया गया कुल टैक्स.
orderDetails

object (OrderDetails)

ऑर्डर बनाते समय, उसके बारे में ज़्यादा जानकारी.
orderHistory

object (OrderHistory)

उन इवेंट के बारे में जानकारी जिन्होंने क्रम में बदलाव किया है.
developerRevenueInBuyerCurrency

object (Money)

खरीदार की मुद्रा में इस ऑर्डर से मिला रेवेन्यू. इसमें कुछ हिस्से के रिफ़ंड, टैक्स, और शुल्क की कटौतियां शामिल हैं. Google, हर सेल में से सामान्य लेन-देन और तीसरे पक्ष के शुल्क काटता है. इसके अलावा, कुछ देशों या इलाकों में वैट भी काटता है.
pointsDetails

object (PointsDetails)

ऑर्डर पर लागू किए गए Play Points. इनमें ऑफ़र की जानकारी, छूट की दर, और पॉइंट की वैल्यू शामिल है.
salesChannel

enum (SalesChannel)

वह सेल्स चैनल जहां से ऑर्डर किया गया है.

राज्य

ऑर्डर की स्थिति.

Enums
STATE_UNSPECIFIED स्टेटस की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता.
PENDING ऑर्डर बना दिया गया है और इसे प्रोसेस किया जाना बाकी है.
PROCESSED ऑर्डर प्रोसेस हो गया है.
CANCELED ऑर्डर को प्रोसेस किए जाने से पहले ही रद्द कर दिया गया था.
PENDING_REFUND रिफ़ंड का अनुरोध किया गया है और इसे प्रोसेस करना बाकी है.
PARTIALLY_REFUNDED ऑर्डर के पेमेंट का कुछ हिस्सा रिफ़ंड कर दिया गया है.
REFUNDED ऑर्डर का पूरा रिफ़ंड जारी किया गया.

BuyerAddress

टैक्स का हिसाब लगाने के लिए, ग्राहक के पते की जानकारी.

JSON के काेड में दिखाना 
{
  "buyerState": string,
  "buyerCountry": string,
  "buyerPostcode": string
}
फ़ील्ड
buyerState

string

खरीदार के पते वाले देश का टॉप-लेवल एडमिनिस्ट्रेटिव सबडिविज़न. अगर Google, ऑर्डर के लिए Merchant of Record है, तो यह जानकारी शामिल नहीं की जाती.
buyerCountry

string

आईएसओ-3166-1 ऐल्फ़ा-2 (संयुक्त राष्ट्र के देश कोड) के आधार पर, दो अक्षर वाला देश कोड.
buyerPostcode

string

किसी पते का पिन कोड. अगर Google, ऑर्डर के लिए कारोबारी या कंपनी के तौर पर रजिस्टर है, तो यह जानकारी शामिल नहीं की जाती.

OrderDetails

ऑर्डर बनाते समय, उसके बारे में ज़्यादा जानकारी.

JSON के काेड में दिखाना 
{
  "taxInclusive": boolean
}
फ़ील्ड
taxInclusive

boolean

इससे पता चलता है कि दिखाई गई कीमत में टैक्स शामिल था या नहीं.

LineItem

किसी लाइन आइटम की जानकारी.

JSON के काेड में दिखाना 
{
  "productTitle": string,
  "productId": string,
  "listingPrice": {
    object (Money)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },

  // Union field details can be only one of the following:
  "oneTimePurchaseDetails": {
    object (OneTimePurchaseDetails)
  },
  "subscriptionDetails": {
    object (SubscriptionDetails)
  },
  "paidAppDetails": {
    object (PaidAppDetails)
  }
  // End of list of possible types for union field details.
}
फ़ील्ड
productTitle

string

डेवलपर की ओर से बताया गया प्रॉडक्ट का नाम. खरीदार की भाषा में दिखाया जाता है. उदाहरण: coins, monthly subscription, etc.
productId

string

खरीदे गए प्रॉडक्ट का आईडी या ऐप्लिकेशन में खरीदारी के लिए एसकेयू (उदाहरण के लिए, 'monthly001' या 'com.some.thing.inapp1').
listingPrice

object (Money)

Play Store पर आइटम की दिखाई गई कीमत. इसमें टैक्स शामिल हो भी सकता है और नहीं भी. इसमें कोई छूट या प्रमोशन शामिल नहीं है.
total

object (Money)

इस लाइन आइटम के लिए, उपयोगकर्ता ने छूट और टैक्स को ध्यान में रखते हुए कुल कितनी रकम चुकाई.
tax

object (Money)

इस लाइन आइटम के लिए चुकाया गया टैक्स.

यूनियन फ़ील्ड details.

details इनमें से सिर्फ़ एक हो सकता है:
oneTimePurchaseDetails

object (OneTimePurchaseDetails)

सिर्फ़ एक बार पैसे चुकाकर की जाने वाली खरीदारी की जानकारी.
subscriptionDetails

object (SubscriptionDetails)

सदस्यता खरीदने की जानकारी.
paidAppDetails

object (PaidAppDetails)

पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन की खरीदारी की जानकारी.

OneTimePurchaseDetails

सिर्फ़ एक बार पैसे चुकाकर की जाने वाली खरीदारी की जानकारी.

JSON के काेड में दिखाना 
{
  "quantity": integer,
  "offerId": string,
  "purchaseOptionId": string,
  "preorderDetails": {
    object (PreorderDetails)
  },
  "rentalDetails": {
    object (RentalDetails)
  }
}
फ़ील्ड
quantity

integer

एक से ज़्यादा आइटम खरीदने के लिए, खरीदे गए आइटम की संख्या.
offerId

string

एक बार की जाने वाली खरीदारी के ऑफ़र का आईडी.
purchaseOptionId

string

खरीदारी के विकल्प का आईडी. यह फ़ील्ड, खरीदारी के दोनों विकल्पों और वैरिएंट ऑफ़र के लिए सेट किया जाता है. खरीदारी के विकल्पों के लिए, यह आईडी खरीदारी के विकल्प की पहचान करता है. वैरिएंट ऑफ़र के लिए, यह आईडी खरीदारी के विकल्प से जुड़ा होता है. साथ ही, offerId के साथ मिलकर यह वैरिएंट ऑफ़र की पहचान करता है.
preorderDetails

object (PreorderDetails)

पहले से किए गए ऑर्डर की जानकारी. इसे सिर्फ़ तब सेट करें, जब खरीदारी पहले से ऑर्डर की गई हो.
rentalDetails

object (RentalDetails)

किराये पर लेने के लिए की गई खरीदारी की जानकारी. इसे सिर्फ़ तब सेट करें, जब किराये पर खरीदारी की गई हो.

PreorderDetails

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

पहले से की गई खरीदारी की जानकारी.

RentalDetails

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

किराये पर ली गई किसी फ़िल्म की खरीदारी की जानकारी.

SubscriptionDetails

सदस्यता खरीदने की जानकारी.

JSON के काेड में दिखाना 
{
  "basePlanId": string,
  "offerId": string,
  "offerPhase": enum (OfferPhase),
  "offerPhaseDetails": {
    object (OfferPhaseDetails)
  },
  "servicePeriodStartTime": string,
  "servicePeriodEndTime": string
}
फ़ील्ड
basePlanId

string

सदस्यता का बुनियादी प्लान आईडी.
offerId

string

मौजूदा सदस्यता ऑफ़र का ऑफ़र आईडी.
offerPhase

enum (OfferPhase)

इस ऑर्डर से फ़ंड की गई बिलिंग अवधि के लिए, कीमत तय करने का फ़ेज़. समर्थन नहीं होना या रुकना. इसके बजाय, offerPhaseDetails का इस्तेमाल करें.
offerPhaseDetails

object (OfferPhaseDetails)

इस ऑर्डर से फ़ंड की गई एनटाइटलमेंट की अवधि के लिए, कीमत के फ़ेज़ की जानकारी.
servicePeriodStartTime

string (Timestamp format)

इस ऑर्डर से फ़ंड की गई बिलिंग अवधि की शुरुआत. यह बिलिंग/सेवा की अवधि शुरू होने के समय का स्नैपशॉट है. यह स्नैपशॉट, ऑर्डर प्रोसेस होने के समय का होता है. इसका इस्तेमाल सिर्फ़ हिसाब रखने के लिए किया जाना चाहिए.

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

string (Timestamp format)

इस ऑर्डर से फ़ंड की गई बिलिंग अवधि के खत्म होने की तारीख. यह ऑर्डर प्रोसेस किए जाने के समय, बिलिंग/सेवा की अवधि खत्म होने के समय का स्नैपशॉट है. इसका इस्तेमाल सिर्फ़ हिसाब रखने के लिए किया जाना चाहिए. सदस्यता सेवा की अवधि खत्म होने का मौजूदा समय पाने के लिए, purchases.subscriptionsv2.get का इस्तेमाल करें.

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

OfferPhase

यह एनटाइटलमेंट की उस अवधि के लिए कीमत तय करने का फ़ेज़ है जिसके लिए इस ऑर्डर से पेमेंट किया गया है.

Enums
OFFER_PHASE_UNSPECIFIED ऑफ़र के फ़ेज़ की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता.
BASE ऑर्डर में बुनियादी कीमत वाली अवधि के लिए पेमेंट किया गया हो.
INTRODUCTORY ऑर्डर से शुरुआती कीमत वाली बिलिंग अवधि के लिए पेमेंट किया जाता है.
FREE_TRIAL इस ऑर्डर से, बिना किसी शुल्क के आज़माने की अवधि के लिए फ़ंड मिलता है.

OfferPhaseDetails

इस ऑर्डर से फ़ंड किए गए एनटाइटलमेंट की अवधि के लिए, कीमत के फ़ेज़ की जानकारी.

JSON के काेड में दिखाना 
{

  // Union field phase_details can be only one of the following:
  "freeTrialDetails": {
    object (FreeTrialDetails)
  },
  "introductoryPriceDetails": {
    object (IntroductoryPriceDetails)
  },
  "baseDetails": {
    object (BaseDetails)
  },
  "prorationPeriodDetails": {
    object (ProrationPeriodDetails)
  }
  // End of list of possible types for union field phase_details.
}
फ़ील्ड
यूनियन फ़ील्ड phase_details. किराया तय करने के चरण की जानकारी. phase_details इनमें से सिर्फ़ एक हो सकता है:
freeTrialDetails

object (FreeTrialDetails)

इस ऑर्डर से, बिना किसी शुल्क के आज़माने की अवधि के लिए फ़ंड मिलता है.
introductoryPriceDetails

object (IntroductoryPriceDetails)

ऑर्डर से शुरुआती कीमत वाली बिलिंग अवधि के लिए पेमेंट किया जाता है.
baseDetails

object (BaseDetails)

ऑर्डर में बुनियादी कीमत वाली अवधि के लिए पेमेंट किया गया हो.
prorationPeriodDetails

object (ProrationPeriodDetails)

ऑर्डर में, समय के हिसाब से तय की गई कीमत के लिए फ़ंड दिया जाता है.

FreeTrialDetails

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

बिना शुल्क के आज़माने के ऑफ़र के फ़ेज़ की जानकारी.

IntroductoryPriceDetails

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

शुरुआती कीमत वाले चरण की जानकारी.

BaseDetails

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

बुनियादी कीमत के हिसाब से किराये तय करने के फ़ेज़ की जानकारी.

ProrationPeriodDetails

किराये में छूट की अवधि की जानकारी.

प्रो रेटेड अवधि, प्लान में बदलाव के दौरान कैलकुलेट की गई ऐसी अवधि हो सकती है जिसमें मौजूदा एनटाइटलमेंट शामिल हों. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं को सदस्यता अपग्रेड, डाउनग्रेड या बदलने की अनुमति देना लेख पढ़ें. इसके अलावा, यह ऐसी प्रो रेटेड अवधि भी हो सकती है जिसमें ऐड-ऑन के रिन्यूअल की तारीखों को बेस प्लान के साथ अलाइन किया गया हो. ज़्यादा जानकारी के लिए, खरीदारी में शामिल आइटम पर लागू होने वाले नियम लेख पढ़ें.

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

enum (OfferPhase)

अगर प्रोरटेड अवधि में इनमें से कोई भी अवधि शामिल है, तो खरीदे गए लाइन आइटम के लिए ओरिजनल ऑफ़र फ़ेज़ दिखाएं. उदाहरण के लिए, CHARGE_FULL_PRICE प्लान में बदलाव करने पर, सदस्यता के ऑफ़र की अवधि के हिसाब से तय की गई कीमत, नए प्रॉडक्ट के लिए उपयोगकर्ता की ओर से खरीदे गए सदस्यता के ऑफ़र के पहले चरण में मर्ज हो सकती है. इस मामले में, ऑफ़र का ओरिजनल फ़ेज़ यहां सेट किया जाएगा.

PaidAppDetails

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

पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन की खरीदारी की जानकारी.

OrderHistory

उन इवेंट की जानकारी जिनसे ऑर्डर में बदलाव हुआ है.

JSON के काेड में दिखाना 
{
  "partialRefundEvents": [
    {
      object (PartialRefundEvent)
    }
  ],
  "processedEvent": {
    object (ProcessedEvent)
  },
  "cancellationEvent": {
    object (CancellationEvent)
  },
  "refundEvent": {
    object (RefundEvent)
  }
}
फ़ील्ड
partialRefundEvents[]

object (PartialRefundEvent)

इस ऑर्डर के लिए, कुछ हिस्से के रिफ़ंड से जुड़े इवेंट की जानकारी.
processedEvent

object (ProcessedEvent)

ऑर्डर प्रोसेस किए जाने की तारीख.
cancellationEvent

object (CancellationEvent)

ऑर्डर रद्द किए जाने की तारीख.
refundEvent

object (RefundEvent)

ऑर्डर का पूरा रिफ़ंड कब दिया गया, इसकी जानकारी.

ProcessedEvent

ऑर्डर प्रोसेस किए जाने की तारीख.

JSON के काेड में दिखाना 
{
  "eventTime": string
}
फ़ील्ड
eventTime

string (Timestamp format)

वह समय जब ऑर्डर को प्रोसेस किया गया था.

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

CancellationEvent

ऑर्डर रद्द किए जाने की तारीख.

JSON के काेड में दिखाना 
{
  "eventTime": string
}
फ़ील्ड
eventTime

string (Timestamp format)

वह समय जब ऑर्डर रद्द किया गया था.

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

RefundEvent

ऑर्डर का पूरा रिफ़ंड कब दिया गया, इसकी जानकारी.

JSON के काेड में दिखाना 
{
  "eventTime": string,
  "refundDetails": {
    object (RefundDetails)
  },
  "refundReason": enum (RefundReason)
}
फ़ील्ड
eventTime

string (Timestamp format)

वह समय जब ऑर्डर का पूरा रिफ़ंड दिया गया था.

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

object (RefundDetails)

पूरे रिफ़ंड की जानकारी.
refundReason

enum (RefundReason)

ऑर्डर का रिफ़ंड करने की वजह.

RefundDetails

कुछ हिस्से या पूरे रिफ़ंड की जानकारी.

JSON के काेड में दिखाना 
{
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  }
}
फ़ील्ड
total

object (Money)

टैक्स के साथ रिफ़ंड की गई कुल रकम.
tax

object (Money)

टैक्स के तौर पर रिफ़ंड की गई रकम.

RefundReason

ऑर्डर का रिफ़ंड करने की वजह.

Enums
REFUND_REASON_UNSPECIFIED orders.refund reason unspecified. इस वैल्यू का इस्तेमाल नहीं किया जाता.
OTHER ऑर्डर के लिए रिफ़ंड, यहां दी गई वजहों के अलावा किसी और वजह से दिया गया था.
CHARGEBACK ऑर्डर के लिए किया गया पेमेंट, रिफ़ंड कर दिया गया है.

PartialRefundEvent

इस ऑर्डर के लिए, कुछ हिस्से का रिफ़ंड देने से जुड़े इवेंट की जानकारी.

JSON के काेड में दिखाना 
{
  "createTime": string,
  "processTime": string,
  "state": enum (State),
  "refundDetails": {
    object (RefundDetails)
  }
}
फ़ील्ड
createTime

string (Timestamp format)

आंशिक रिफ़ंड बनाए जाने का समय.

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

string (Timestamp format)

वह समय, जब कुछ हिस्से का रिफ़ंड प्रोसेस किया गया था.

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

enum (State)

कुछ हिस्से के रिफ़ंड का स्टेटस.
refundDetails

object (RefundDetails)

कुछ हिस्से के रिफ़ंड की जानकारी.

राज्य

कुछ हिस्से के रिफ़ंड का स्टेटस.

Enums
STATE_UNSPECIFIED स्टेटस की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता.
PENDING आंशिक रिफ़ंड बना दिया गया है, लेकिन अब तक प्रोसेस नहीं किया गया है.
PROCESSED_SUCCESSFULLY आंशिक रिफ़ंड प्रोसेस कर दिया गया है.

PointsDetails

किसी ऑर्डर पर लागू किए गए Play पॉइंट से जुड़ी जानकारी.

JSON के काेड में दिखाना 
{
  "pointsOfferId": string,
  "pointsCouponValue": {
    object (Money)
  },
  "pointsDiscountRateMicros": string,
  "pointsSpent": string
}
फ़ील्ड
pointsOfferId

string

इस ऑर्डर के लिए इस्तेमाल किए जा रहे Play पॉइंट ऑफ़र का यूनीक आईडी.
pointsCouponValue

object (Money)

Play Points कूपन की मॉनेटरी वैल्यू. यह कूपन से मिलने वाली छूट है. ऐसा हो सकता है कि यह कुल रकम न हो. यह कुकी सिर्फ़ तब सेट की जाती है, जब Play Points के कूपन इस्तेमाल किए गए हों. उदाहरण के लिए, 2 डॉलर के कूपन के लिए 100 पॉइंट की वैल्यू 2 डॉलर है.
pointsDiscountRateMicros

string (int64 format)

प्रतिशत की वह दर जिससे Play Points प्रमोशन की वजह से कीमत कम हो जाती है. उदाहरण के लिए, 2 डॉलर के कूपन के लिए 100 पॉइंट की वैल्यू 5,00,000 है. $2 के लिए 200 पॉइंट का अनुमान लगाया गया है. हालांकि, इसके लिए ज़रूरी पॉइंट की संख्या 100 है, जो अनुमानित पॉइंट का 50% है. साथ ही, 50% माइक्रो में 5, 00,000 होता है. यह वैल्यू 0 से 10,00,000 के बीच होनी चाहिए.
pointsSpent

string (int64 format)

इस ऑर्डर में इस्तेमाल किए गए Play पॉइंट की संख्या. उदाहरण के लिए, अगर 2 डॉलर के कूपन के लिए 100 पॉइंट मिलते हैं, तो यह वैल्यू 100 होगी. बेस ऑफ़र के साथ स्टैक किए गए कूपन के लिए, यह दोनों पर खर्च किए गए कुल पॉइंट हैं.

SalesChannel

वह सेल्स चैनल जहां से ऑर्डर किया गया है.

Enums
SALES_CHANNEL_UNSPECIFIED बिक्री चैनल की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता.
IN_APP ऐप्लिकेशन में शुरू किए गए स्टैंडर्ड ऑर्डर.
PC_EMULATOR पीसी एम्युलेटर से शुरू किए गए ऑर्डर, जो इन-ऐप्लिकेशन खरीदारी के लिए होते हैं.
NATIVE_PC इन-ऐप्लिकेशन खरीदारी के लिए, नेटिव पीसी ऐप्लिकेशन से शुरू किए गए ऑर्डर.
PLAY_STORE Google Play Store से शुरू किए गए ऑर्डर.
OUTSIDE_PLAY_STORE Google Play Store के बाहर से शुरू किए गए ऑर्डर.

तरीके

batchget

 ऑर्डर की सूची के लिए, ऑर्डर की जानकारी पाएं.

get

 किसी एक ऑर्डर की जानकारी पाएं.

refund

 इससे किसी व्यक्ति की सदस्यता या इन-ऐप्लिकेशन खरीदारी के ऑर्डर का रिफ़ंड दिया जाता है.

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

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

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

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