- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- PageSelection
- इसे आज़माएं!
इसमें उन खरीदारी की सूची होती है जिन्हें रद्द किया गया है, जिनके लिए रिफ़ंड किया गया है या जिन पर शुल्क लिया गया है.
एचटीटीपी अनुरोध
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
packageName |
उस ऐप्लिकेशन का पैकेज नाम जिसके लिए रद्द की गई खरीदारी को लौटाया जाना है (उदाहरण के लिए, 'com.some.thing'). |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSelection.maxResults |
इससे तय होता है कि सूची कार्रवाई के कितने नतीजे मिलने चाहिए. डिफ़ॉल्ट नंबर, संसाधन से इकट्ठा किए गए डेटा पर निर्भर करता है. |
pageSelection.startIndex |
रिटर्न किए जाने वाले पहले एलिमेंट के इंडेक्स के बारे में बताता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब इंडेक्स किए गए पेज का इस्तेमाल करने की सुविधा चालू हो. |
pageSelection.token |
दिखाए जाने वाले पेज के टोकन के बारे में बताता है. आम तौर पर, इसे TokenPaगिनेशन से लिया जाता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब टोकन पेजिंग की सुविधा चालू हो. |
startTime |
Epoch के बाद के मिलीसेकंड में, सबसे पुरानी रद्द की गई खरीदारी का वह समय जिसे आपको रिस्पॉन्स में देखना है. इस पैरामीटर की वैल्यू 30 दिन से ज़्यादा पुरानी नहीं हो सकती. साथ ही, अगर पेज पर नंबर डालने वाला टोकन सेट किया जाता है, तो उसे अनदेखा कर दिया जाता है. डिफ़ॉल्ट वैल्यू, मौजूदा समय में से 30 दिनों को घटाने पर सेट होती है. ध्यान दें: यह फ़िल्टर उस समय लागू किया जाता है जब हमारे सिस्टम की ओर से रिकॉर्ड को अमान्य के रूप में देखा जाता है, न कि जवाब में वापस आए असल समय के खाली होने के समय. |
endTime |
Epoch के बाद के मिलीसेकंड में, सबसे नई रद्द की गई खरीदारी का वह समय जिसे आपको जवाब में देखना है. इस पैरामीटर की वैल्यू, मौजूदा समय से ज़्यादा नहीं हो सकती. साथ ही, अगर पेज पर नंबर डालने वाला टोकन सेट किया जाता है, तो उसे अनदेखा कर दिया जाता है. डिफ़ॉल्ट वैल्यू, मौजूदा समय पर सेट होती है. ध्यान दें: यह फ़िल्टर उस समय लागू किया जाता है जब हमारे सिस्टम की ओर से रिकॉर्ड को अमान्य के रूप में देखा जाता है, न कि जवाब में वापस आए असल समय के खाली होने के समय. |
type |
रद्द की गई खरीदारी का वह टाइप जिसे आपको जवाब में देखना है. संभावित वैल्यू ये हैं: 0. जवाब के तौर पर, सिर्फ़ ऐप्लिकेशन में खरीदे जा सकने वाले रद्द किए गए प्रॉडक्ट वापस किए जाएंगे. यह डिफ़ॉल्ट मान है. 1. जवाब के तौर पर, रद्द की गई इन-ऐप्लिकेशन खरीदारी और रद्द की गई सदस्यता, दोनों को वापस कर दिया जाएगा. ध्यान दें: रद्द की गई सदस्यता की खरीदारी का अनुरोध करने से पहले, आपको जवाब में orderId का इस्तेमाल करना होगा. इससे एक बार की जाने वाली खरीदारी और सदस्यताओं की खास पहचान की जा सकेगी. ऐसा न होने पर, आपको एक ही PurchaseToken के साथ कई सदस्यता ऑर्डर मिलेंगे. इसकी वजह यह है कि सदस्यता के रिन्यूअल के ऑर्डर में एक ही PurchaseToken शेयर किया जाता है. |
includeQuantityBasedPartialRefund |
ज़रूरी नहीं. संख्या के हिसाब से कुछ हिस्से के रिफ़ंड की रद्द की गई खरीदारी को शामिल करना है या नहीं, जो सिर्फ़ एक से ज़्यादा यूनिट की खरीदारी पर लागू होती हैं. अगर सही हो, तो रद्द की गई अतिरिक्त खरीदारी को रद्द की गई संख्या के साथ लौटाया जा सकता है. इसमें, आइटम के आधार पर किए गए कुछ हिस्से के रिफ़ंड की संख्या के बारे में बताया जाता है. डिफ़ॉल्ट मान असत्य है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
voidedpurchases.list API के लिए जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "pageInfo": { object ( |
फ़ील्ड | |
---|---|
pageInfo |
पेज पर नंबर डालने की सामान्य जानकारी. |
tokenPagination |
टोकन पेजिनेशन के लिए, पेज पर नंबर डालने की जानकारी. |
voidedPurchases[] |
|
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/androidpublisher
PageSelection
pageSelection के अनुरोध वाले पैरामीटर का टाइप, जो यह तय करता है कि voidedpurchases.list कार्रवाई के ज़रिए कौनसे और कितने नतीजे मिलने चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
फ़ील्ड | |
---|---|
maxResults |
इससे तय होता है कि सूची कार्रवाई के कितने नतीजे मिलने चाहिए. डिफ़ॉल्ट नंबर, संसाधन से इकट्ठा किए गए डेटा पर निर्भर करता है. |
startIndex |
रिटर्न किए जाने वाले पहले एलिमेंट के इंडेक्स के बारे में बताता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब इंडेक्स किए गए पेज का इस्तेमाल करने की सुविधा चालू हो. |
token |
दिखाए जाने वाले पेज के टोकन के बारे में बताता है. आम तौर पर, इसे TokenPaगिनेशन से लिया जाता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब टोकन पेजिंग की सुविधा चालू हो. |