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

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

string (int64 format)

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

string (int64 format)

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

integer

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

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

boolean

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

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

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

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

voidedpurchases.list API के लिए रिस्पॉन्स.

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

JSON के काेड में दिखाना 
{
  "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 ऑपरेशन को कौनसे और कितने नतीजे दिखाने चाहिए.

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

integer (uint32 format)

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

integer (uint32 format)

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

string

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