- संसाधन: ऑर्डर
- राज्य
- BuyerAddress
- OrderDetails
- LineItem
- OneTimePurchaseDetails
- RentalDetails
- SubscriptionDetails
- OfferPhase
- PaidAppDetails
- OrderHistory
- ProcessedEvent
- CancellationEvent
- RefundEvent
- RefundDetails
- RefundReason
- PartialRefundEvent
- राज्य
- PointsDetails
- तरीके
संसाधन: ऑर्डर
Order संसाधन में, Google Play पर किए गए लेन-देन के बारे में पूरी जानकारी शामिल होती है. इसमें कई एट्रिब्यूट शामिल होते हैं. इनसे ऑर्डर, खरीदे गए प्रॉडक्ट, और ऑर्डर से जुड़े इवेंट के इतिहास के बारे में जानकारी मिलती है.
ऑर्डर एपीआई की मदद से, Google Play के नेटवर्क में मौजूद ऑर्डर डेटा को रीयल-टाइम में ऐक्सेस किया जा सकता है. एक बार और बार-बार होने वाले ऑर्डर, दोनों के लिए ज़्यादा जानकारी और मेटाडेटा वापस पाया जा सकता है. इसमें लेन-देन की जानकारी भी शामिल है. जैसे, शुल्क, टैक्स, और रिफ़ंड. साथ ही, इसमें मेटाडेटा भी शामिल है. जैसे, सदस्यता के लिए कीमत के चरण. Orders API की मदद से, ऑर्डर मैनेज करने से जुड़े टास्क अपने-आप पूरे किए जा सकते हैं. इससे, Play Console के ज़रिए मैन्युअल तरीके से जांच करने की ज़रूरत कम हो जाती है.
इस एपीआई के इस्तेमाल के कुछ उदाहरण यहां दिए गए हैं:
रीयल-टाइम में ऑर्डर का डेटा वापस पाना - orders.get का इस्तेमाल करके, ऑर्डर आईडी की मदद से खरीदारी करने के तुरंत बाद ऑर्डर की जानकारी और मेटाडेटा वापस पाएं.
ऑर्डर के अपडेट को सिंक करना - ऑर्डर की जानकारी का अप-टू-डेट रिकॉर्ड बनाए रखने के लिए, ऑर्डर के अपडेट को समय-समय पर सिंक करें.
ध्यान दें:
Orders API के कॉल, Play Developer API के आपके कोटा में गिने जाते हैं. यह कोटा डिफ़ॉल्ट रूप से हर दिन 2 लाख होता है. हालांकि, ऑर्डर के लंबे इतिहास को सिंक करने के लिए यह कोटा काफ़ी नहीं हो सकता.
हर कॉल में ज़्यादा से ज़्यादा 1,000 ऑर्डर वापस पाए जा सकते हैं. हमारा सुझाव है कि कोटा के इस्तेमाल को कम करने के लिए, बड़े पेज साइज़ का इस्तेमाल करें. Cloud Console में अपना कोटा देखें. अगर आपको इससे ज़्यादा की ज़रूरत है, तो कोटा बढ़ाने का अनुरोध करें.
JSON के काेड में दिखाना |
---|
{ "lineItems": [ { object ( |
फ़ील्ड | |
---|---|
lineItems[] |
इस ऑर्डर में शामिल अलग-अलग लाइन आइटम. |
orderId |
ऑर्डर आईडी. |
purchaseToken |
यह टोकन, उपयोगकर्ता के डिवाइस को तब दिया जाता है, जब सदस्यता या आइटम खरीदा जाता है. |
state |
ऑर्डर की स्थिति. |
createTime |
ऑर्डर किए जाने का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
lastEventTime |
ऑर्डर पर हुआ आखिरी इवेंट का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
buyerAddress |
टैक्स का हिसाब लगाने के लिए, ग्राहक के पते की जानकारी. जब Google, ऑर्डर के लिए मर्चेंट ऑफ़ रिकॉर्ड होता है, तब सिर्फ़ देश का नाम दिखता है. |
total |
कुल रकम जो खरीदार ने दी. इसमें छूट और टैक्स शामिल हैं. |
tax |
इस ऑर्डर के लिए चुकाया गया कुल टैक्स. |
orderDetails |
ऑर्डर बनाते समय, उसके बारे में ज़्यादा जानकारी. |
orderHistory |
उन इवेंट की जानकारी जिनसे ऑर्डर में बदलाव हुआ है. |
developerRevenueInBuyerCurrency |
इस ऑर्डर के लिए, खरीदार की मुद्रा में आपका रेवेन्यू. इसमें कुछ हिस्से के रिफ़ंड, टैक्स, और शुल्क की कटौतियां शामिल हैं. Google हर बिक्री में से सामान्य लेन-देन और तीसरे पक्ष के शुल्क काटता है. साथ ही, कुछ क्षेत्रों में वैट भी कटता है. |
pointsDetails |
ऑर्डर पर लागू किए गए Play Points. इनमें ऑफ़र की जानकारी, छूट की दर, और पॉइंट की वैल्यू शामिल है. |
स्थिति
ऑर्डर की स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
स्टेटस की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
PENDING |
ऑर्डर बना दिया गया है और इसे प्रोसेस किया जाना बाकी है. |
PROCESSED |
ऑर्डर प्रोसेस हो गया है. |
CANCELED |
ऑर्डर को प्रोसेस किए जाने से पहले ही रद्द कर दिया गया था. |
PENDING_REFUND |
रिफ़ंड का अनुरोध किया गया है और इसे प्रोसेस करना बाकी है. |
PARTIALLY_REFUNDED |
ऑर्डर के पेमेंट का कुछ हिस्सा रिफ़ंड कर दिया गया है. |
REFUNDED |
ऑर्डर के लिए किए गए पूरे पेमेंट का रिफ़ंड कर दिया गया है. |
BuyerAddress
टैक्स का हिसाब लगाने के लिए, ग्राहक के पते की जानकारी.
JSON के काेड में दिखाना |
---|
{ "buyerState": string, "buyerCountry": string, "buyerPostcode": string } |
फ़ील्ड | |
---|---|
buyerState |
खरीदार के पते वाले देश का टॉप-लेवल एडमिनिस्ट्रेटिव सबडिविज़न. अगर Google, ऑर्डर के लिए कारोबारी या कंपनी के तौर पर रजिस्टर है, तो यह जानकारी शामिल नहीं की जाती. |
buyerCountry |
आईएसओ-3166-1 ऐल्फ़ा-2 (संयुक्त राष्ट्र के देश कोड) के आधार पर, दो अक्षर वाला देश कोड. |
buyerPostcode |
किसी पते का पिन कोड. अगर Google, ऑर्डर के लिए कारोबारी या कंपनी के तौर पर रजिस्टर है, तो यह जानकारी शामिल नहीं की जाती. |
OrderDetails
ऑर्डर बनाते समय, उसके बारे में ज़्यादा जानकारी.
JSON के काेड में दिखाना |
---|
{ "taxInclusive": boolean } |
फ़ील्ड | |
---|---|
taxInclusive |
इससे पता चलता है कि दिखाई गई कीमत में टैक्स शामिल था या नहीं. |
LineItem
किसी लाइन आइटम की जानकारी.
JSON के काेड में दिखाना |
---|
{ "productTitle": string, "productId": string, "listingPrice": { object ( |
फ़ील्ड | |
---|---|
productTitle |
डेवलपर की ओर से बताया गया प्रॉडक्ट का नाम. खरीदार की भाषा में दिखाया जाता है. उदाहरण: coins, monthly subscription, etc. |
productId |
खरीदे गए प्रॉडक्ट का आईडी या ऐप्लिकेशन में खरीदारी के लिए एसकेयू (उदाहरण के लिए, 'monthly001' या 'com.some.thing.inapp1'). |
listingPrice |
Play Store पर आइटम की दिखाई गई कीमत. इसमें टैक्स शामिल हो भी सकता है और नहीं भी. इसमें कोई छूट या प्रमोशन शामिल नहीं है. |
total |
इस लाइन आइटम के लिए, उपयोगकर्ता ने छूट और टैक्स को ध्यान में रखते हुए कुल कितनी रकम चुकाई. |
tax |
इस लाइन आइटम के लिए चुकाया गया टैक्स. |
यूनियन फ़ील्ड
|
|
oneTimePurchaseDetails |
सिर्फ़ एक बार पैसे चुकाकर की जाने वाली खरीदारी की जानकारी. |
subscriptionDetails |
सदस्यता खरीदने की जानकारी. |
paidAppDetails |
पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन की खरीदारी की जानकारी. |
OneTimePurchaseDetails
सिर्फ़ एक बार पैसे चुकाकर की जाने वाली खरीदारी की जानकारी.
JSON के काेड में दिखाना |
---|
{
"quantity": integer,
"offerId": string,
"purchaseOptionId": string,
"rentalDetails": {
object ( |
फ़ील्ड | |
---|---|
quantity |
एक से ज़्यादा आइटम खरीदने के लिए, खरीदे गए आइटम की संख्या. |
offerId |
एक बार की जाने वाली खरीदारी के ऑफ़र का आईडी. |
purchaseOptionId |
खरीदारी के विकल्प का आईडी. यह फ़ील्ड, खरीदारी के दोनों विकल्पों और वैरिएंट ऑफ़र के लिए सेट किया जाता है. खरीदारी के विकल्पों के लिए, यह आईडी खरीदारी के विकल्प की पहचान करता है. वैरिएंट ऑफ़र के लिए, यह आईडी खरीदारी के विकल्प से जुड़ा होता है. साथ ही, offerId के साथ मिलकर यह वैरिएंट ऑफ़र की पहचान करता है. |
rentalDetails |
किराये पर लेने के लिए की गई खरीदारी की जानकारी. इसे सिर्फ़ तब सेट करें, जब खरीदारी किराये पर ली गई हो. |
RentalDetails
इस टाइप में कोई फ़ील्ड नहीं है.
किराये पर ली गई किसी फ़िल्म की खरीदारी की जानकारी.
SubscriptionDetails
सदस्यता खरीदने की जानकारी.
JSON के काेड में दिखाना |
---|
{
"basePlanId": string,
"offerId": string,
"offerPhase": enum ( |
फ़ील्ड | |
---|---|
basePlanId |
सदस्यता का बुनियादी प्लान आईडी. |
offerId |
मौजूदा सदस्यता ऑफ़र का ऑफ़र आईडी. |
offerPhase |
इस ऑर्डर से फ़ंड की गई बिलिंग अवधि के लिए, कीमत तय करने का फ़ेज़. |
servicePeriodStartTime |
इस ऑर्डर से फ़ंड की गई बिलिंग अवधि की शुरुआत. यह बिलिंग/सेवा की अवधि शुरू होने के समय का स्नैपशॉट है. यह स्नैपशॉट, ऑर्डर प्रोसेस होने के समय का होता है. इसका इस्तेमाल सिर्फ़ हिसाब रखने के लिए किया जाना चाहिए. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
servicePeriodEndTime |
इस ऑर्डर से फ़ंड की गई बिलिंग अवधि के खत्म होने की तारीख. यह बिलिंग/सेवा की अवधि खत्म होने के समय का स्नैपशॉट है. यह स्नैपशॉट तब लिया जाता है, जब ऑर्डर प्रोसेस किया जाता है. इसका इस्तेमाल सिर्फ़ हिसाब रखने के लिए किया जाना चाहिए. सदस्यता सेवा की अवधि खत्म होने का मौजूदा समय पाने के लिए, purchases.subscriptionsv2.get का इस्तेमाल करें. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
OfferPhase
यह एनटाइटलमेंट की उस अवधि के लिए कीमत तय करने का फ़ेज़ है जिसके लिए इस ऑर्डर से पेमेंट किया गया है.
Enums | |
---|---|
OFFER_PHASE_UNSPECIFIED |
ऑफ़र के फ़ेज़ की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
BASE |
ऑर्डर में बुनियादी कीमत वाली अवधि के लिए पेमेंट किया गया हो. |
INTRODUCTORY |
ऑर्डर से शुरुआती कीमत वाली बिलिंग अवधि के लिए पेमेंट किया जाता है. |
FREE_TRIAL |
इस ऑर्डर से, बिना किसी शुल्क के आज़माने की अवधि के लिए फ़ंड मिलता है. |
PaidAppDetails
इस टाइप में कोई फ़ील्ड नहीं है.
पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन की खरीदारी की जानकारी.
OrderHistory
उन इवेंट की जानकारी जिनसे ऑर्डर में बदलाव हुआ है.
JSON के काेड में दिखाना |
---|
{ "partialRefundEvents": [ { object ( |
फ़ील्ड | |
---|---|
partialRefundEvents[] |
इस ऑर्डर के लिए, कुछ हिस्से के रिफ़ंड से जुड़े इवेंट की जानकारी. |
processedEvent |
ऑर्डर प्रोसेस किए जाने की तारीख. |
cancellationEvent |
ऑर्डर रद्द किए जाने की तारीख. |
refundEvent |
ऑर्डर का पूरा रिफ़ंड कब दिया गया, इसकी जानकारी. |
ProcessedEvent
ऑर्डर प्रोसेस किए जाने की तारीख.
JSON के काेड में दिखाना |
---|
{ "eventTime": string } |
फ़ील्ड | |
---|---|
eventTime |
वह समय जब ऑर्डर को प्रोसेस किया गया था. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
CancellationEvent
ऑर्डर रद्द किए जाने की तारीख.
JSON के काेड में दिखाना |
---|
{ "eventTime": string } |
फ़ील्ड | |
---|---|
eventTime |
वह समय जब ऑर्डर रद्द किया गया था. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
RefundEvent
ऑर्डर का पूरा रिफ़ंड कब दिया गया, इसकी जानकारी.
JSON के काेड में दिखाना |
---|
{ "eventTime": string, "refundDetails": { object ( |
फ़ील्ड | |
---|---|
eventTime |
वह समय जब ऑर्डर का पूरा रिफ़ंड दिया गया था. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
refundDetails |
पूरे रिफ़ंड की जानकारी. |
refundReason |
ऑर्डर का रिफ़ंड करने की वजह. |
RefundDetails
कुछ हिस्से या पूरे रिफ़ंड की जानकारी.
JSON के काेड में दिखाना |
---|
{ "total": { object ( |
फ़ील्ड | |
---|---|
total |
टैक्स के साथ रिफ़ंड की गई कुल रकम. |
tax |
टैक्स के तौर पर रिफ़ंड की गई रकम. |
RefundReason
ऑर्डर का रिफ़ंड करने की वजह.
Enums | |
---|---|
REFUND_REASON_UNSPECIFIED |
orders.refund reason unspecified. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
OTHER |
ऑर्डर के लिए रिफ़ंड, यहां दी गई वजहों के अलावा किसी और वजह से दिया गया था. |
CHARGEBACK |
ऑर्डर के लिए किया गया पेमेंट, रिफ़ंड कर दिया गया है. |
PartialRefundEvent
इस ऑर्डर के लिए, कुछ हिस्से के रिफ़ंड से जुड़े इवेंट की जानकारी.
JSON के काेड में दिखाना |
---|
{ "createTime": string, "processTime": string, "state": enum ( |
फ़ील्ड | |
---|---|
createTime |
आंशिक रिफ़ंड बनाए जाने का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
processTime |
वह समय जब कुछ हिस्से का रिफ़ंड प्रोसेस किया गया था. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
state |
कुछ हिस्से के रिफ़ंड की स्थिति. |
refundDetails |
कुछ हिस्से के रिफ़ंड की जानकारी. |
स्थिति
कुछ हिस्से के रिफ़ंड की स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
स्टेटस की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
PENDING |
आंशिक रिफ़ंड की प्रोसेस शुरू कर दी गई है, लेकिन अब तक इसे पूरा नहीं किया गया है. |
PROCESSED_SUCCESSFULLY |
आंशिक रिफ़ंड प्रोसेस कर दिया गया है. |
PointsDetails
किसी ऑर्डर पर लागू किए गए Play Points से जुड़ी जानकारी.
JSON के काेड में दिखाना |
---|
{
"pointsOfferId": string,
"pointsCouponValue": {
object ( |
फ़ील्ड | |
---|---|
pointsOfferId |
इस ऑर्डर के लिए इस्तेमाल किए जा रहे Play पॉइंट ऑफ़र का यूनीक आईडी. |
pointsCouponValue |
Play Points कूपन की मॉनेटरी वैल्यू. यह कूपन से मिलने वाली छूट है. ऐसा हो सकता है कि यह कुल रकम न हो. यह कुकी सिर्फ़ तब सेट की जाती है, जब Play Points के कूपन इस्तेमाल किए गए हों. उदाहरण के लिए, 100 पॉइंट के बदले 2 डॉलर का कूपन पाने के लिए, यह 2 डॉलर है. |
pointsDiscountRateMicros |
प्रतिशत की वह दर जिससे Play Points प्रमोशन की वजह से कीमत कम हो जाती है. उदाहरण के लिए, 2 डॉलर के कूपन के लिए 100 पॉइंट की वैल्यू 5,00,000 है. दो डॉलर के लिए 200 पॉइंट का अनुमान लगाया गया है. हालांकि, इसके लिए ज़रूरी पॉइंट 100 हैं, जो अनुमानित पॉइंट का 50% है. वहीं, 50% माइक्रो में 5, 00,000 होता है. यह वैल्यू 0 से 10,00,000 के बीच होनी चाहिए. |
pointsSpent |
इस ऑर्डर में इस्तेमाल किए गए Play पॉइंट की संख्या. उदाहरण के लिए, अगर 2 डॉलर के कूपन के लिए 100 पॉइंट मिलते हैं, तो यह वैल्यू 100 होगी. अगर कूपन को मूल ऑफ़र के साथ स्टैक किया गया है, तो यह दोनों पर खर्च किए गए कुल पॉइंट हैं. |
तरीके |
|
---|---|
|
ऑर्डर की सूची के लिए, ऑर्डर की जानकारी पाएं. |
|
किसी एक ऑर्डर की जानकारी पाएं. |
|
इससे किसी व्यक्ति की सदस्यता या इन-ऐप्लिकेशन खरीदारी के ऑर्डर का रिफ़ंड दिया जाता है. |
गड़बड़ी के कोड
इस संसाधन के ऑपरेशन, यहां दिए गए एचटीटीपी गड़बड़ी कोड दिखाते हैं:
गड़बड़ी का कोड | कारण | रिज़ॉल्यूशन |
---|---|---|
5xx |
Google Play सर्वर में सामान्य गड़बड़ी. | अनुरोध को फिर से भेजें.
अगर समस्या बनी रहती है, तो अपने Google Play खाता मैनेजर से संपर्क करें या सहायता का अनुरोध सबमिट करें. अगर आपको किसी समस्या के बारे में पहले से पता है, तो Play का स्टेटस डैशबोर्ड देखें. |
409 |
एक साथ कई अपडेट करने पर गड़बड़ी हुई.
किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे पहले से ही अपडेट किया जा रहा है. उदाहरण के लिए, Play Billing Library के |
अनुरोध को फिर से भेजें. |