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