अमान्य खरीदारी की एपीआई

Google Play Voided Purchases API ऐसे ऑर्डर की सूची उपलब्ध कराता है जो उन खरीदारी से जुड़े होते हैं जिन्हें उपयोगकर्ता ने रद्द कर दिया है. इस्तेमाल की जा सकने वाली जानकारी का इस्तेमाल इस सूची से एक रद्द करने का सिस्टम लागू करेगा, जो उपयोगकर्ता को उन ऑर्डर से प्रॉडक्ट ऐक्सेस करने में मदद मिलती है.

यह एपीआई, एक बार किए जाने वाले इन-ऐप्लिकेशन ऑर्डर और ऐप्लिकेशन की सदस्यताओं पर लागू होता है.

किसी खरीदारी को इन तरीकों से रद्द किया जा सकता है:

• उपयोगकर्ता अपने ऑर्डर के लिए रिफ़ंड का अनुरोध करता है.
• उपयोगकर्ता अपने ऑर्डर को रद्द कर देता है.
• किसी ऑर्डर का शुल्क वापस कर दिया जाता है.

• डेवलपर ऑर्डर को रद्द कर देता है या उसका रिफ़ंड दे देता है.

  ध्यान दें: सिर्फ़ निरस्त किए गए ऑर्डर, Voided Purchases API में दिखेंगे. अगर कोई डेवलपर खरीदारी रद्द करने का विकल्प सेट किए बिना, किसी खरीदारी का रिफ़ंड देता है, तो एपीआई की मदद से ऑर्डर को लौटाया नहीं जा सकता.

• Google, ऑर्डर को रद्द कर देता है या उसका रिफ़ंड दे देता है.

इस एपीआई का इस्तेमाल करके, आप सभी को बेहतर और निष्पक्ष अनुभव देने में मदद करते हैं के उपयोगकर्ताओं की संख्या बढ़ानी है, खास तौर पर तब, जब आपका ऐप्लिकेशन एक गेम हो.

ध्यान दें: ऑर्डर से जुड़े अन्य डेटा सोर्स के उलट, Voided Purchases API इसमें ऐसी खरीदारी शामिल है जिसका शुल्क, पेमेंट प्रोसेस करने वाली कंपनी ने वापस किया है. इसलिए, आपको इस एपीआई में दी गई जानकारी और ऑर्डर से जुड़े अन्य डेटा सोर्स से मिली जानकारी.

ध्यान दें: Voided Purchases API सिर्फ़ तब रद्द की गई खरीदारी दिखाता है, जब ज़रूरी हो निरस्त किया जाना चाहिए. डेवलपर इस एपीआई का इस्तेमाल यह बताने के लिए कर सकते हैं कि कोई कार्रवाई नहीं करनी होगी. हालांकि, कुछ खरीदारी के लिए आपको रिफ़ंड मिल सकता है होने के साथ-साथ यह भी बताना होगा कि डेवलपर ने खरीदारी को कभी स्वीकार नहीं किया था और इसलिए, हो सकता है कि यह डेवलपर के रिकॉर्ड में मौजूद न हो.

ऐक्सेस पाना

Voided Purchases API का इस्तेमाल करने के लिए, आपके पास इसे देखने की अनुमति होनी चाहिए वित्तीय जानकारी. अनुमति देने के लिए, OAuth क्लाइंट या सेवा खाता. अगर किसी सेवा खाते का इस्तेमाल किया जा रहा है, तो "वित्तीय डेटा देखें रिपोर्ट" अनुमति नहीं है.

Google Play डेवलपर एपीआई का आधिकारिक ऐक्सेस पाने के बारे में ज़्यादा जानने के लिए, यहां देखें नीचे दी गई गाइड देखें:

• एपीआई ऐक्सेस क्लाइंट को सेट अप करना
• डेवलपर खाते के उपयोगकर्ताओं को जोड़ना और अनुमतियां मैनेज करें

रद्द की गई खरीदारी देखना

रद्द की गई खरीदारी की सूची का अनुरोध करने के लिए, GET तरीके का इस्तेमाल करें. आपके अनुरोध में, अपने ऐप्लिकेशन के लिए, पूरी तरह क्वालिफ़ाइड पैकेज का नाम शामिल करना होगा—जैसे com.google.android.apps.maps—और वह ऑथराइज़ेशन टोकन जिसे आपने एपीआई का ऐक्सेस पाने पर मिला.

GET https://www.googleapis.com/androidpublisher/v3/applications/
your_package_name/purchases/voidedpurchases?access_token=your_auth_token

अपने अनुरोध में ये पैरामीटर भी शामिल किए जा सकते हैं. इनमें से हर पैरामीटर ज़रूरी नहीं:

startTime

सबसे पुराना समय, जो Unix epoch के बाद से मिलीसेकंड में है रद्द की गई खरीदारी जिसे आपको जवाब में देखना है. डिफ़ॉल्ट रूप से, startTime को 30 दिन पहले पर सेट किया गया है.

एपीआई सिर्फ़ रद्द की गई ऐसी खरीदारी दिखा सकता है जो पिछली बार रद्द की गई हों 30 दिन. जवाब में पुरानी रद्द की गई खरीदारी शामिल नहीं की जाती हैं, भले ही का मान दिखाई देगा, जो आपने startTime के लिए दिया है.

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

endTime

सबसे नए का समय, मिलीसेकंड में Unix epoch के बाद से रद्द की गई खरीदारी जिसे आप जवाब में देखना चाहते हैं. डिफ़ॉल्ट रूप से, endTime मौजूदा समय पर सेट है.

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

ज़्यादा से ज़्यादा नतीजे

हर जवाब में दिखने वाली रद्द की गई खरीदारी की ज़्यादा से ज़्यादा संख्या. इन्होंने बदलाव किया है डिफ़ॉल्ट तौर पर, यह वैल्यू 1000 होती है. ध्यान दें कि इस पैरामीटर की सबसे ज़्यादा वैल्यू है यह संख्या 1,000 है.

टोकन

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

टाइप

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

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

includeQuantityBasedPartialRefund

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

ध्यान दें: जब एक खरीदारी का रिफ़ंड मिल जाता है, तो रद्द की गई खरीदारी के लिए voidedQuantity, जिससे यह पता चलता है कि खरीदारी में रिफ़ंड हो गया है. उदाहरण के लिए, अगर 10 नंबर की खरीदारी के लिए 3 का रिफ़ंड दिया जाता है संख्या 2, 3, और 5 होने पर, 3 रद्द की गई खरीदारी होगी. पहला रद्द की गई दो खरीदारी पर, 2 और 3 का voidedQuantity होगा. हालांकि, रद्द की गई तीसरी खरीदारी में voidedQuantity नहीं होगा.

रिस्पॉन्स, एक JSON स्ट्रिंग होती है जिसमें रद्द की गई खरीदारी की सूची शामिल होती है. अगर वहां maxResults अनुरोध पैरामीटर में बताई गई संख्या से ज़्यादा नतीजे हैं है, तो रिस्पॉन्स में nextPageToken की एक वैल्यू शामिल होती है, जिसे आप ज़्यादा परिणाम देखने के लिए बाद का अनुरोध. सूची में मौजूद पहले नतीजे में रद्द की गई सबसे पुरानी खरीदारी.

{
  "tokenPagination": {
    "nextPageToken": "next_page_token"
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_purchase_token",
      "purchaseTimeMillis": "1468825200000",
      "voidedTimeMillis": "1469430000000",
      "orderId": "some_order_id",
      "voidedSource": "0",
      "voidedReason": "4"
    },
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_other_purchase_token",
      "purchaseTimeMillis": "1468825100000",
      "voidedTimeMillis": "1470034800000",
      "orderId": "some_other_order_id",
      "voidedSource": "2",
      "voidedReason": "5"
    },
  ]
}

कोटा

Voided Purchases API हर पैकेज के लिए, ये कोटा सेट करता है:

• 6,000 क्वेरी हर दिन. (यह दिन, पैसिफ़िक समय के हिसाब से आधी रात को शुरू और खत्म होता है.)
• किसी भी 30-सेकंड की अवधि के दौरान 30 क्वेरी.

शुरुआती अनुरोधों के लिए दिशा-निर्देश

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

• maxResults पैरामीटर के लिए, डिफ़ॉल्ट वैल्यू का इस्तेमाल करें. इस तरह, अगर आपको एक दिन के लिए आपका पूरा क्वेरी कोटा होता है, तो आप अपनी साइट पर मौजूद 60,00,000 रद्द की गई खरीदारी.
• अगर किसी रिस्पॉन्स में nextPageToken के लिए कोई वैल्यू शामिल है, तो इस वैल्यू को आपके अगले अनुरोध के दौरान, token पैरामीटर.

सबसे सही तरीके

ध्यान दें: इस एपीआई का इस्तेमाल करने के अलावा, डेवलपर को डेवलपर से जुड़ी रीयल-टाइम सूचनाएं (आरटीडीएन). आरटीडीएन की मदद से, आपको Google से सूचनाएं मिलती हैं. आपके ऐप्लिकेशन में किसी उपयोगकर्ता के एनटाइटलमेंट में बदलाव. इसमें उपयोगकर्ता को मिलने वाले फ़ायदे भी शामिल हैं खरीदारी को रद्द किया जाता है.

अपने ऐप्लिकेशन में इस एपीआई का इस्तेमाल करते समय, याद रखें कि कई को रद्द करने का विकल्प नहीं होता है और यह कि ऐसी कोई एक सेवा मौजूद नहीं है जो सभी केस. सहमति रद्द करते समय, आपको अपने उपयोगकर्ताओं का ध्यान रखना चाहिए नीतियों और रणनीतियों के बारे में बात करेंगे. ऐसा करने के लिए, सुझाए गए इन तरीकों का इस्तेमाल किया जा सकता है:

• इस एपीआई का इस्तेमाल, समस्याओं से निपटने के लिए बेहतर रणनीति में कई एलिमेंट में से एक के तौर पर करें अनचाहा व्यवहार. इन-ऐप्लिकेशन प्रॉडक्ट का ऐक्सेस वापस लेना आम तौर पर ज़्यादा असरदार होता है जब इसे किसी ऐसे ऐप्लिकेशन के साथ जोड़ा जाता है जिसमें इन-ऐप्लिकेशन खरीदारी की कीमत सही होती है, तो ऐप्लिकेशन का ऐसा डिज़ाइन जो अनचाहे व्यवहार को रोकता है, एक ऐसा मज़बूत उपयोगकर्ता आधार जिसका का इस्तेमाल, इस तरह के बर्ताव को अस्वीकार करता है. साथ ही, उपयोगकर्ता के रिस्पॉन्सिबल और कुशल सहायता को बढ़ावा नहीं देता है. चैनल.
• सभी उपयोगकर्ताओं के लिए निष्पक्षता को पक्का करने के लिए, सहमति रद्द करने की अपनी नीति को एक जैसा रखें.
• अनचाहे व्यवहार को ठीक करने के लिए, कुछ लोगों के लिए बनाई गई नीति बनाने के बारे में सोचें. इसके लिए उदाहरण के लिए, शुरुआती अपराधों के लिए इन-ऐप्लिकेशन चेतावनियों से शुरुआत करें और फिर अपने उपयोगकर्ता के अनचाहे व्यवहार को जारी रखने के लिए. अंतिम उपाय के रूप में, आप यह कर सकते हैं उपयोगकर्ता को आपके ऐप्लिकेशन के साथ इंटरैक्ट करने से बिलकुल भी रोक सकता है.
• सहमति रद्द करने की नीति लागू करते समय और हर बार उसे अपडेट करने के दौरान, के संपर्क करके, अपने उपयोगकर्ताओं को बदलावों के बारे में सूचित करें. अपने उपयोगकर्ताओं को इससे पहले कि आप इन बदलावों को अपने ऐप्लिकेशन में लागू करें, उन्हें साफ़ तौर पर समझ लें.
• अपने उपयोगकर्ताओं के साथ पारदर्शिता बनाए रखें और जब भी आप कोई कार्रवाई करें, तो उन्हें सूचित करें, जैसे कि इन-ऐप्लिकेशन प्रॉडक्ट का ऐक्सेस वापस लेने पर. आम तौर पर, उपयोगकर्ताओं को विवाद सुलझाने की प्रक्रिया का इस्तेमाल किया जाना चाहिए.
• सुझाव, शिकायत या राय वाले फ़ॉर्म और कम्यूनिटी फ़ोरम पर नज़र रखें, ताकि आपको पता चल सके कि उपयोगकर्ता किस वजह से इस साइट पर आते हैं और इस तरह की गतिविधियों को अंजाम देने के लिए सही तरीके इस्तेमाल न करना. इन पर कार्रवाई करें जानकारी को सुरक्षित रखना.