Method: orders.reviewrefund

चार्जबैक के अनुरोध के लिए, रिफ़ंड पाने का तरीका और खरीदारी के इस्तेमाल की जानकारी देना

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

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

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

पाथ पैरामीटर

पैरामीटर
packageName

string

ज़रूरी है. उस ऐप्लिकेशन के पैकेज का नाम जिसके लिए यह सदस्यता या इन-ऐप्लिकेशन आइटम खरीदा गया था. उदाहरण के लिए, 'com.some.thing'.
orderId

string

ज़रूरी है. सदस्यता या इन-ऐप्लिकेशन ऑर्डर खरीदने पर, उपयोगकर्ता को दिया गया ऑर्डर आईडी.

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
फ़ील्ड
pendingRefundToken

string

ज़रूरी है. रिफ़ंड की समीक्षा से जुड़ी सूचना में शामिल, रिफ़ंड का टोकन.
sampleContentProvided

boolean

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

enum (RefundPreference)

ज़रूरी है. इससे आपकी पसंद के बारे में पता चलता है. यह आपकी ऑपरेशनल लॉजिक पर आधारित होती है. इससे पता चलता है कि Play Store को रिफ़ंड देना चाहिए या नहीं.
consumptionPercentageMilliunits

integer

ज़रूरी नहीं. ग्राहक ने इन-ऐप्लिकेशन खरीदारी का कितना हिस्सा इस्तेमाल किया, यह मिलीयूनिट में दिखाया जाता है. कम से कम: 0 ज़्यादा से ज़्यादा: 1,00,000. पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन के लिए, इसे हटाया जा सकता है. उदाहरण : 45200 का मतलब 45.2% है.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

ज़रूरी नहीं. इवेंट की सूची. हर इवेंट, उस इंस्टेंस को दिखाता है जहां उपयोगकर्ता ने खरीदे गए आइटम या सेवा का इस्तेमाल किया. 1,000 से ज़्यादा आइटम वाली सूचियों को अस्वीकार कर दिया जाएगा.

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

अगर अनुरोध पूरा हो जाता है, तो जवाब का मुख्य हिस्सा खाली होता है.

अनुमति पाने के लिंक

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

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

RefundPreference

इससे आपकी पसंद के बारे में पता चलता है. यह आपकी ऑपरेशनल लॉजिक पर आधारित होती है. इससे पता चलता है कि Play Store को रिफ़ंड देना चाहिए या नहीं.

Enums
REFUND_PREFERENCE_UNSPECIFIED orders.refund preference की जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाता.
DECLINE डेवलपर चाहता है कि Play रिफ़ंड को अस्वीकार कर दे.
APPROVE डेवलपर चाहता है कि Play पूरा रिफ़ंड दे.
NEUTRAL डेवलपर को Google Play के रिफ़ंड देने के फ़ैसले से कोई आपत्ति नहीं है

ConsumptionUsageEvent

इवेंट की सूची. हर इवेंट, उस इंस्टेंस को दिखाता है जहां उपयोगकर्ता ने खरीदे गए आइटम या सेवा का इस्तेमाल किया.

JSON के काेड में दिखाना 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
फ़ील्ड
obfuscatedAccountId

string

ज़रूरी नहीं. यह एक ऐसी स्ट्रिंग होती है जिसे छिपाया गया होता है. यह स्ट्रिंग, ऐप्लिकेशन में खरीदार के उपयोगकर्ता खाते से यूनीक तरीके से जुड़ी होती है. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

ज़रूरी नहीं. यह एक ऐसी स्ट्रिंग होती है जिसे छिपाया गया होता है. यह स्ट्रिंग, ऐप्लिकेशन में खरीदार की उपयोगकर्ता प्रोफ़ाइल से यूनीक तरीके से जुड़ी होती है. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

ज़रूरी नहीं. वह समय, जब उपयोगकर्ता ने कॉन्टेंट का इस्तेमाल किया, उसे डाउनलोड किया, खोला या स्ट्रीम किया.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
ipAddress

string

ज़रूरी नहीं. वह आईपी पता जिससे डेटा इस्तेमाल किया गया.
consumptionItemDescription

string

ज़रूरी नहीं. फ़्री फ़ॉर्म टेक्स्ट, जिसकी मदद से डेवलपर, इस्तेमाल किए गए आइटम के बारे में ज़्यादा जानकारी दे सकते हैं. ज़्यादा से ज़्यादा 5,000 वर्ण इस्तेमाल किए जा सकते हैं.
location

object (CoarseLocation)

ज़रूरी नहीं. वह भौगोलिक जगह जहां कॉन्टेंट देखा गया.

CoarseLocation

उपयोगकर्ता ने जिस जगह पर कॉन्टेंट देखा है उसकी अनुमानित भौगोलिक जगह की जानकारी.

JSON के काेड में दिखाना 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
फ़ील्ड
regionCode

string

ज़रूरी है. पते में दिए गए देश/इलाके का देश/इलाके का CLDR कोड. इस वैल्यू का अनुमान कभी नहीं लगाया जाता. इसलिए, आपको यह पक्का करना होगा कि वैल्यू सही हो. उदाहरण के लिए, स्विट्ज़रलैंड के लिए "CH".
administrativeArea

string

ज़रूरी नहीं. किसी देश या इलाके के डाक पते के लिए इस्तेमाल किया जाने वाला सबसे बड़ा एडमिनिस्ट्रेटिव सबडिविज़न. उदाहरण के लिए, यह कोई राज्य, प्रांत, ओब्लास्ट या प्रीफ़ेक्चर (प्रांत) हो सकता है. स्पेन के लिए, यह प्रांत है, न कि ऑटोनॉमस कम्यूनिटी (उदाहरण के लिए, "बार्सिलोना" और "कैटलोनिया" नहीं). कई देशों में, डाक पते में प्रशासनिक क्षेत्र का इस्तेमाल नहीं किया जाता. उदाहरण के लिए, स्विट्ज़रलैंड में इसे खाली छोड़ देना चाहिए.
locality

string

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

string

ज़रूरी नहीं. पते का उप-इलाका. उदाहरण के लिए, यह कोई मोहल्ला, नगर या ज़िला हो सकता है. ज़्यादातर पतों के लिए, इसे हटाया जा सकता है.