Method: purchases.voidedpurchases.list

इसमें उन खरीदारी की सूची होती है जिन्हें रद्द किया गया है, जिनके लिए रिफ़ंड किया गया है या जिन पर शुल्क लिया गया है.

एचटीटीपी अनुरोध

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
packageName

string

उस ऐप्लिकेशन का पैकेज नाम जिसके लिए रद्द की गई खरीदारी को लौटाया जाना है (उदाहरण के लिए, 'com.some.thing').

क्वेरी पैरामीटर

पैरामीटर
pageSelection.maxResults

integer (uint32 format)

इससे तय होता है कि सूची कार्रवाई के कितने नतीजे मिलने चाहिए. डिफ़ॉल्ट नंबर, संसाधन से इकट्ठा किए गए डेटा पर निर्भर करता है.
pageSelection.startIndex

integer (uint32 format)

रिटर्न किए जाने वाले पहले एलिमेंट के इंडेक्स के बारे में बताता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब इंडेक्स किए गए पेज का इस्तेमाल करने की सुविधा चालू हो.
pageSelection.token

string

दिखाए जाने वाले पेज के टोकन के बारे में बताता है. आम तौर पर, इसे TokenPaगिनेशन से लिया जाता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब टोकन पेजिंग की सुविधा चालू हो.
startTime

string (int64 format)

Epoch के बाद के मिलीसेकंड में, सबसे पुरानी रद्द की गई खरीदारी का वह समय जिसे आपको रिस्पॉन्स में देखना है. इस पैरामीटर की वैल्यू 30 दिन से ज़्यादा पुरानी नहीं हो सकती. साथ ही, अगर पेज पर नंबर डालने वाला टोकन सेट किया जाता है, तो उसे अनदेखा कर दिया जाता है. डिफ़ॉल्ट वैल्यू, मौजूदा समय में से 30 दिनों को घटाने पर सेट होती है. ध्यान दें: यह फ़िल्टर उस समय लागू किया जाता है जब हमारे सिस्टम की ओर से रिकॉर्ड को अमान्य के रूप में देखा जाता है, न कि जवाब में वापस आए असल समय के खाली होने के समय.
endTime

string (int64 format)

Epoch के बाद के मिलीसेकंड में, सबसे नई रद्द की गई खरीदारी का वह समय जिसे आपको जवाब में देखना है. इस पैरामीटर की वैल्यू, मौजूदा समय से ज़्यादा नहीं हो सकती. साथ ही, अगर पेज पर नंबर डालने वाला टोकन सेट किया जाता है, तो उसे अनदेखा कर दिया जाता है. डिफ़ॉल्ट वैल्यू, मौजूदा समय पर सेट होती है. ध्यान दें: यह फ़िल्टर उस समय लागू किया जाता है जब हमारे सिस्टम की ओर से रिकॉर्ड को अमान्य के रूप में देखा जाता है, न कि जवाब में वापस आए असल समय के खाली होने के समय.
type

integer

रद्द की गई खरीदारी का वह टाइप जिसे आपको जवाब में देखना है. संभावित वैल्यू ये हैं: 0. जवाब के तौर पर, सिर्फ़ ऐप्लिकेशन में खरीदे जा सकने वाले रद्द किए गए प्रॉडक्ट वापस किए जाएंगे. यह डिफ़ॉल्ट मान है. 1. जवाब के तौर पर, रद्द की गई इन-ऐप्लिकेशन खरीदारी और रद्द की गई सदस्यता, दोनों को वापस कर दिया जाएगा.

ध्यान दें: रद्द की गई सदस्यता की खरीदारी का अनुरोध करने से पहले, आपको जवाब में orderId का इस्तेमाल करना होगा. इससे एक बार की जाने वाली खरीदारी और सदस्यताओं की खास पहचान की जा सकेगी. ऐसा न होने पर, आपको एक ही PurchaseToken के साथ कई सदस्यता ऑर्डर मिलेंगे. इसकी वजह यह है कि सदस्यता के रिन्यूअल के ऑर्डर में एक ही PurchaseToken शेयर किया जाता है.
includeQuantityBasedPartialRefund

boolean

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

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

voidedpurchases.list API के लिए जवाब.

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

जेएसओएन के काेड में दिखाना 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
फ़ील्ड
pageInfo

object (PageInfo)

पेज पर नंबर डालने की सामान्य जानकारी.
tokenPagination

object (TokenPagination)

टोकन पेजिनेशन के लिए, पेज पर नंबर डालने की जानकारी.
voidedPurchases[]

object (VoidedPurchase)

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/androidpublisher

PageSelection

pageSelection के अनुरोध वाले पैरामीटर का टाइप, जो यह तय करता है कि voidedpurchases.list कार्रवाई के ज़रिए कौनसे और कितने नतीजे मिलने चाहिए.

जेएसओएन के काेड में दिखाना 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
फ़ील्ड
maxResults

integer (uint32 format)

इससे तय होता है कि सूची कार्रवाई के कितने नतीजे मिलने चाहिए. डिफ़ॉल्ट नंबर, संसाधन से इकट्ठा किए गए डेटा पर निर्भर करता है.
startIndex

integer (uint32 format)

रिटर्न किए जाने वाले पहले एलिमेंट के इंडेक्स के बारे में बताता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब इंडेक्स किए गए पेज का इस्तेमाल करने की सुविधा चालू हो.
token

string

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