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

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

startTime

string (int64 format)

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

endTime

string (int64 format)

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

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

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