- संसाधन: SubscriptionPurchase
- IntroductoryPriceInfo
- SubscriptionCancelSurveyResult
- SubscriptionPriceChange
- तरीके
रिसॉर्स: SubscriptionPurchase
SubscriptionPurchase रिसॉर्स से, उपयोगकर्ता की सदस्यता खरीदारी की स्थिति का पता चलता है.
JSON के काेड में दिखाना |
---|
{ "kind": string, "startTimeMillis": string, "expiryTimeMillis": string, "autoResumeTimeMillis": string, "autoRenewing": boolean, "priceCurrencyCode": string, "priceAmountMicros": string, "introductoryPriceInfo": { object ( |
फ़ील्ड | |
---|---|
kind |
यह टाइप, androidpublisher सेवा में subscriptionPurchase ऑब्जेक्ट को दिखाता है. |
startTimeMillis |
सदस्यता मिलने का समय, मिलीसेकंड में. यह समय, Epoch के बाद का होता है. |
expiryTimeMillis |
सदस्यता की समयसीमा खत्म होने का समय, मिलीसेकंड में. |
autoResumeTimeMillis |
वह समय जब सदस्यता अपने-आप फिर से शुरू हो जाएगी. यह समय, 'एपिक' के बाद के मिलीसेकंड में दिया जाता है. यह सिर्फ़ तब दिखता है, जब उपयोगकर्ता ने सदस्यता रोकने का अनुरोध किया हो. |
autoRenewing |
सदस्यता की समयसीमा खत्म होने पर, क्या वह अपने-आप रिन्यू होगी. |
priceCurrencyCode |
सदस्यता की कीमत के लिए ISO 4217 मुद्रा कोड. उदाहरण के लिए, अगर कीमत ब्रिटिश पाउंड में दी गई है, तो priceCurrencyCode "GBP" होगा. |
priceAmountMicros |
सदस्यता की कीमत. टैक्स के बिना कीमत वाले देशों के लिए, कीमत में टैक्स शामिल नहीं होता. जिन देशों में टैक्स शामिल है वहां कीमत में टैक्स भी शामिल होता है. कीमत को माइक्रो-यूनिट में दिखाया जाता है. यहां 1, 000,000 माइक्रो-यूनिट,मुद्रा की एक इकाई के बराबर होते हैं. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMicros की वैल्यू 1990000 होगी. |
introductoryPriceInfo |
सदस्यता की शुरुआती कीमत की जानकारी. यह सिर्फ़ तब दिखता है, जब सदस्यता को शुरुआती कीमत पर खरीदा गया हो. इस फ़ील्ड से यह पता नहीं चलता कि सदस्यता फ़िलहाल शुरुआती कीमत वाली अवधि में है या नहीं. |
countryCode |
सदस्यता मिलने के समय, उपयोगकर्ता के देश/इलाके का ISO 3166-1 alpha-2 बिलिंग कोड. |
developerPayload |
डेवलपर की तय की गई स्ट्रिंग, जिसमें किसी ऑर्डर के बारे में अतिरिक्त जानकारी होती है. |
paymentState |
सदस्यता के लिए किए गए पेमेंट की स्थिति. वैल्यू, इनमें से कोई हो सकती है: 0. पेमेंट को मंज़ूरी मिलना बाकी है 1. पेमेंट मिल गया 2. मुफ़्त में आज़माएं 3. अपग्रेड/डाउनग्रेड की प्रक्रिया पूरी नहीं हुई रद्द की गई और समयसीमा खत्म हो चुकी सदस्यताओं के लिए उपलब्ध नहीं है. |
cancelReason |
सदस्यता रद्द होने या अपने-आप रिन्यू न होने की वजह. वैल्यू, इनमें से कोई हो सकती है: 0. उपयोगकर्ता ने पहली सदस्यता रद्द कर दी. सिस्टम ने सदस्यता रद्द कर दी है. उदाहरण के लिए, बिलिंग से जुड़ी समस्या की वजह से. सदस्यता को नई सदस्यता 3 से बदल दिया गया. डेवलपर ने सदस्यता रद्द कर दी है |
userCancellationTimeMillis |
वह समय जब उपयोगकर्ता ने सदस्यता रद्द की थी. यह समय, युग के शुरू होने के बाद के मिलीसेकंड में होता है. यह सिर्फ़ तब मौजूद होता है, जब cancelReason 0 हो. |
cancelSurveyResult |
सदस्यता रद्द करने की प्रोसेस पूरी करने के बाद, उपयोगकर्ता से मिली जानकारी (सदस्यता रद्द करने की वजह का सर्वे). |
orderId |
सदस्यता की खरीदारी से जुड़े, बार-बार होने वाले नए ऑर्डर का ऑर्डर आईडी. अगर पेमेंट अस्वीकार होने की वजह से सदस्यता रद्द की गई थी, तो यह अस्वीकार किए गए पेमेंट के ऑर्डर का ऑर्डर आईडी होगा. |
linkedPurchaseToken |
अगर यह सदस्यता इनमें से कोई है, तो मूल खरीदारी का टोकन: 0. रद्द की गई, लेकिन खत्म नहीं हुई सदस्यता के लिए फिर से साइन अप करना 1. पिछली सदस्यता को अपग्रेड या डाउनग्रेड करना उदाहरण के लिए, मान लें कि कोई उपयोगकर्ता मूल रूप से साइन अप करता है और आपको सदस्यता खरीदने का टोकन X मिलता है. इसके बाद, उपयोगकर्ता सदस्यता रद्द कर देता है और सदस्यता खत्म होने से पहले, फिर से साइन अप करने की प्रोसेस पूरी करता है. इस दौरान, आपको सदस्यता खरीदने का टोकन Y मिलता है. आखिर में, उपयोगकर्ता अपनी सदस्यता को अपग्रेड करता है और आपको सदस्यता खरीदने का टोकन Z मिलता है. अगर इस एपीआई को खरीदारी टोकन Z के साथ कॉल किया जाता है, तो यह फ़ील्ड Y पर सेट हो जाएगा. अगर इस एपीआई को खरीदारी टोकन Y के साथ कॉल किया जाता है, तो यह फ़ील्ड X पर सेट हो जाएगा. अगर इस एपीआई को खरीदारी टोकन X के साथ कॉल किया जाता है, तो यह फ़ील्ड सेट नहीं होगा. |
purchaseType |
सदस्यता खरीदने का तरीका. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब यह खरीदारी स्टैंडर्ड इन-ऐप्लिकेशन बिलिंग फ़्लो का इस्तेमाल करके नहीं की गई थी. वैल्यू, इनमें से कोई हो सकती है: 0. टेस्ट (जैसे, लाइसेंस टेस्टिंग खाते से खरीदा गया) 1. प्रोमो (जैसे, प्रोमो कोड का इस्तेमाल करके खरीदा गया) |
priceChange |
कीमत में हुए बदलाव की नई जानकारी उपलब्ध है. यह सिर्फ़ तब दिखता है, जब सदस्यता की कीमत में बदलाव होने वाला हो, लेकिन वह अभी तक लागू नहीं हुआ हो. सदस्यता को नई कीमत पर रिन्यू करने या रद्द करने के बाद, कीमत में हुए बदलाव की कोई जानकारी नहीं दी जाएगी. |
profileName |
सदस्यता खरीदने के समय, उपयोगकर्ता की प्रोफ़ाइल का नाम. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए उपलब्ध है. |
emailAddress |
सदस्यता खरीदते समय उपयोगकर्ता का ईमेल पता. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए उपलब्ध है. |
givenName |
सदस्यता खरीदते समय उपयोगकर्ता का दिया गया नाम. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए उपलब्ध है. |
familyName |
सदस्यता खरीदते समय उपयोगकर्ता का उपनाम. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद है. |
profileId |
सदस्यता खरीदने के समय, उपयोगकर्ता का Google प्रोफ़ाइल आईडी. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद है. |
acknowledgementState |
सदस्यता वाले प्रॉडक्ट की पुष्टि की स्थिति. वैल्यू, इनमें से कोई हो सकती है: 0. स्वीकार नहीं किया गया 1. स्वीकृत |
externalAccountId |
तीसरे पक्ष की सेवा में उपयोगकर्ता खाते का आइडेंटिफ़ायर. यह सिर्फ़ तब दिखता है, जब सदस्यता खरीदने की प्रोसेस के दौरान खाता लिंक किया गया हो. |
promotionType |
इस खरीदारी पर लागू किया गया प्रमोशन टाइप. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब सदस्यता खरीदते समय कोई प्रमोशन लागू किया गया हो. वैल्यू, इनमें से कोई हो सकती है: 0. एक बार इस्तेमाल होने वाला कोड 1. वैनिटी कोड |
promotionCode |
इस खरीदारी पर लागू किया गया प्रोमो कोड. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब सदस्यता खरीदते समय कोई वैनिटी कोड प्रोमो लागू किया गया हो. |
obfuscatedExternalAccountId |
आईडी का ऐसा वर्शन जिसे बदला गया हो. यह आईडी, आपके ऐप्लिकेशन में उपयोगकर्ता के खाते से खास तौर पर जुड़ा होता है. यह इन खरीदारी के लिए मौजूद होता है: * अगर सदस्यता खरीदने के फ़्लो के दौरान खाता लिंक किया गया हो. * खरीदारी करते समय, https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid का इस्तेमाल करके, यह जानकारी दी गई थी. |
obfuscatedExternalProfileId |
आईडी का ऐसा वर्शन जिसे छिपाया गया है. यह आपके ऐप्लिकेशन में उपयोगकर्ता की प्रोफ़ाइल से खास तौर पर जुड़ा होता है. यह सिर्फ़ तब मौजूद होता है, जब खरीदारी करते समय https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid का इस्तेमाल करके बताया गया हो. |
IntroductoryPriceInfo
इसमें किसी सदस्यता के लिए, शुरुआती कीमत की जानकारी शामिल होती है.
JSON के काेड में दिखाना |
---|
{ "introductoryPriceCurrencyCode": string, "introductoryPriceAmountMicros": string, "introductoryPricePeriod": string, "introductoryPriceCycles": integer } |
फ़ील्ड | |
---|---|
introductoryPriceCurrencyCode |
शुरुआती सदस्यता की कीमत के लिए, ISO 4217 मुद्रा कोड. उदाहरण के लिए, अगर कीमत ब्रिटिश पाउंड में दी गई है, तो priceCurrencyCode "GBP" होगा. |
introductoryPriceAmountMicros |
सदस्यता की शुरुआती कीमत, जिसमें टैक्स शामिल नहीं है. मुद्रा, priceCurrencyCode जैसी ही है. कीमत को माइक्रो-यूनिट में दिखाया जाता है. यहां 1, 000,000 माइक्रो-यूनिट,मुद्रा की एक इकाई के बराबर होते हैं. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMicros की वैल्यू 1990000 होगी. |
introductoryPricePeriod |
शुरुआती कीमत की अवधि, जो ISO 8601 फ़ॉर्मैट में दी गई है. आम तौर पर, "P1W" (एक हफ़्ता), "P1M" (एक महीना), "P3M" (तीन महीने), "P6M" (छह महीने), और "P1Y" (एक साल) जैसी वैल्यू इस्तेमाल की जाती हैं. हालांकि, इनके अलावा और भी वैल्यू इस्तेमाल की जा सकती हैं. |
introductoryPriceCycles |
शुरुआती कीमत की सुविधा देने के लिए, बिलिंग अवधि की संख्या. |
SubscriptionCancelSurveyResult
सदस्यता रद्द करने की प्रोसेस पूरी करने के बाद, उपयोगकर्ता से मिली जानकारी (सदस्यता रद्द करने की वजह का सर्वे).
JSON के काेड में दिखाना |
---|
{ "cancelSurveyReason": integer, "userInputCancelReason": string } |
फ़ील्ड | |
---|---|
cancelSurveyReason |
सदस्यता रद्द करने की वह वजह जो उपयोगकर्ता ने सर्वे में चुनी है. वैल्यू, इनमें से कोई हो सकती है: 0. अन्य 1. यह सेवा मेरे लिए बहुत ज़्यादा काम की नहीं है 2. तकनीकी समस्याएं 3. कीमत से जुड़ी वजहें 4. मुझे एक बेहतर ऐप्लिकेशन मिला है |
userInputCancelReason |
उपयोगकर्ता की ओर से सदस्यता रद्द करने की वजह. यह सिर्फ़ तब मौजूद होता है, जब cancelReason 0 हो. |
SubscriptionPriceChange
इसमें सदस्यता की कीमत में हुए बदलाव की जानकारी होती है. इसका इस्तेमाल, ऐप्लिकेशन में कीमत में हुए बदलाव के लिए उपयोगकर्ता के सफ़र को कंट्रोल करने के लिए किया जा सकता है. यह उपयोगकर्ता से पुष्टि करने के लिए कहा जा सकता है या कन्वर्ज़न को बेहतर बनाने के लिए अनुभव को बेहतर बनाया जा सकता है.
JSON के काेड में दिखाना |
---|
{
"newPrice": {
object ( |
फ़ील्ड | |
---|---|
newPrice |
अगर उपयोगकर्ता कीमत में हुए बदलाव को स्वीकार करता है, तो सदस्यता को इस नई कीमत पर रिन्यू किया जाएगा. |
state |
कीमत में बदलाव की मौजूदा स्थिति. वैल्यू, इनमें से कोई हो सकती है: 0. बाकी है: कीमत में हुए ऐसे बदलाव की स्थिति जिस पर उपयोगकर्ता की सहमति मिलना बाकी है. इस स्थिति में, आपके पास In-App API का इस्तेमाल करके, उपयोगकर्ता से पुष्टि करने का विकल्प होता है. 1. स्वीकार किया गया: कीमत में हुए उस बदलाव के लिए बताएं जिसे स्वीकार कर लिया गया है. सदस्यता को तब तक रिन्यू किया जाएगा, जब तक उसे रद्द नहीं किया जाता. कीमत में बदलाव, सदस्यता के रिन्यू होने की तारीख को लागू होता है. ध्यान दें कि अगली बार सदस्यता रिन्यू होने पर, हो सकता है कि यह बदलाव न हो. |
तरीके |
|
---|---|
|
सदस्यता खरीदने की पुष्टि करता है. |
|
उपयोगकर्ता की सदस्यता की खरीदारी रद्द करता है. |
|
उपयोगकर्ता की सदस्यता खरीदारी को, सदस्यता खत्म होने के तय समय तक के लिए रोक देता है. |
(deprecated) |
बंद कर दिया गया: इसके बजाय, purchases.subscriptionsv2.get का इस्तेमाल करें. |
(deprecated) |
इस्तेमाल नहीं किया जा सकता: इसके बजाय, orders.refund का इस्तेमाल करें. |
(deprecated) |
बंद कर दिया गया: इसके बजाय, purchases.subscriptionsv2.revoke का इस्तेमाल करें. |