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)

आपको जवाब में, रद्द की गई जिस नई खरीदारी की जानकारी देखनी है उसका समय, माइक्रोसेकंड में. यह समय, एपर्च (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)

नमूना

अनुरोध का सैंपल यहां दिया गया है:

curl -X GET \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.some.thing/purchases/voidedpurchases?endTime=1678886400000&includeQuantityBasedPartialRefund=true&maxResults=10&startIndex=0&startTime=1676208000000&token=SAMPLE_PAGINATION_TOKEN&type=1'

यहां जवाब का एक सैंपल दिया गया है:

{
  "pageInfo": {
    "resultPerPage": 10,
    "startIndex": 0,
    "totalResults": 25
  },
  "tokenPagination": {
    "nextPageToken": "c3RhdGVfZm9yX3BhZ2VfMg==",
    "previousPageToken": null
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "orderId": "GPA.3315-1234-5678-90123",
      "purchaseTimeMillis": "1678886400000",
      "purchaseToken": "aebkhenchpfeidbefgkcjmfi.AO-J1OykGjJh9r_V7_v0kI6bA4v88e5c44f4e0c4b4a8e0e4f4g4h4i4j4k4l4m4n4o4p4q4r4s4t4u4v4w4x4y4z",
      "voidedQuantity": 1,
      "voidedReason": 1,
      "voidedSource": 0,
      "voidedTimeMillis": "1678972800000"
    },
    {
      "kind": "androidpublisher#voidedPurchase",
      "orderId": "GPA.3377-9876-5432-10987.0",
      "purchaseTimeMillis": "1678713600000",
      "purchaseToken": "fkgdjdmfgmcmflekdgmdncj.AO-J1OyU6sXvB9LqRt3jD2wZ_pE8gXyF5hT3mN1zK0aP7bV4qL9cO6iR2sD0kM7oU1bL8jI3sF5tY9vU4wO1eP2g",
      "voidedQuantity": 1,
      "voidedReason": 7,
      "voidedSource": 2,
      "voidedTimeMillis": "1678800000000"
    }
  ]
}

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

नीचे दिए गए 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 से लिया जाता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब टोकन पेजिंग की सुविधा चालू हो.