REST Resource: purchases.subscriptions

• संसाधन: SubscriptionPurchase
  • JSON काेड में दिखाना
• IntroductoryPriceInfo
  • JSON काेड में दिखाना
• SubscriptionCancelSurveyResult
  • JSON काेड में दिखाना
• SubscriptionPriceChange
  • JSON काेड में दिखाना
• तरीके

संसाधन: SubscriptionPurchase

SubscriptionPurchase संसाधन, उपयोगकर्ता की सदस्यता की खरीदारी की स्थिति दिखाता है.

JSON के काेड में दिखाना

{ "kind": string, "startTimeMillis": string, "expiryTimeMillis": string, "autoResumeTimeMillis": string, "autoRenewing": boolean, "priceCurrencyCode": string, "priceAmountMicros": string, "introductoryPriceInfo": { object (IntroductoryPriceInfo) }, "countryCode": string, "developerPayload": string, "paymentState": integer, "cancelReason": integer, "userCancellationTimeMillis": string, "cancelSurveyResult": { object (SubscriptionCancelSurveyResult) }, "orderId": string, "linkedPurchaseToken": string, "purchaseType": integer, "priceChange": { object (SubscriptionPriceChange) }, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string, "profileId": string, "acknowledgementState": integer, "externalAccountId": string, "promotionType": integer, "promotionCode": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string }

फ़ील्ड
kind	string यह तरह, androidpublisher सेवा में subscriptionPurchase ऑब्जेक्ट को दिखाता है.
startTimeMillis	string (int64 format) सदस्यता दिए जाने का समय, Epoch के बाद के मिलीसेकंड में.
expiryTimeMillis	string (int64 format) वह समय जब सदस्यता खत्म हो जाएगी. यह समय, Epoch के बाद के मिलीसेकंड में होता है.
autoResumeTimeMillis	string (int64 format) वह समय जब सदस्यता अपने-आप फिर से शुरू हो जाएगी. यह समय, Epoch के बाद के मिलीसेकंड में होता है. यह पैरामीटर सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने सदस्यता को कुछ समय के लिए रोकने का अनुरोध किया हो.
autoRenewing	boolean सदस्यता की मौजूदा समयसीमा खत्म होने पर, वह अपने-आप रिन्यू होगी या नहीं.
priceCurrencyCode	string सदस्यता के लिए आईएसओ 4217 मुद्रा कोड. उदाहरण के लिए, अगर कीमत ब्रिटिश पाउंड स्टर्लिंग में दी गई है, तो priceCurrencyCode "GBP" होगा.
priceAmountMicros	string (int64 format) सदस्यता की कीमत. जिन देशों में टैक्स शामिल नहीं किया जाता है वहां कीमत में टैक्स शामिल नहीं होता. जिन देशों में टैक्स शामिल करके कीमत तय की जाती है वहां कीमत में टैक्स भी शामिल होता है. कीमत को माइक्रो-यूनिट में दिखाया जाता है. यहां 10, 00,000 माइक्रो-यूनिट,मुद्रा की एक यूनिट के बराबर होता है. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMicros 1990000 होगा.
introductoryPriceInfo	object (IntroductoryPriceInfo) सदस्यता की शुरुआती कीमत की जानकारी. यह जानकारी सिर्फ़ तब दिखती है, जब सदस्यता शुरुआती कीमत पर खरीदी गई हो. इस फ़ील्ड से यह पता नहीं चलता कि सदस्यता फ़िलहाल शुरुआती कीमत वाली अवधि में है.
countryCode	string सदस्यता लेते समय, उपयोगकर्ता के बिलिंग देश/इलाके का ISO 3166-1 ऐल्फ़ा-2 कोड.
developerPayload	string डेवलपर की ओर से तय की गई ऐसी स्ट्रिंग जिसमें किसी ऑर्डर के बारे में अतिरिक्त जानकारी होती है.
paymentState	integer सदस्यता के पेमेंट की स्थिति. इसकी वैल्यू 0 हो सकती है. पेमेंट को मंज़ूरी मिलना बाकी है. पेमेंट मिला 2. मुफ़्त में आज़माने की सुविधा 3. अपग्रेड/डाउनग्रेड करने का अनुरोध पूरा नहीं हुआ रद्द की गई और समयसीमा खत्म हो चुकी सदस्यताओं के लिए यह मौजूद नहीं होता.
cancelReason	integer सदस्यता रद्द होने या अपने-आप रिन्यू न होने की वजह. इसकी वैल्यू 0 हो सकती है. उपयोगकर्ता ने सदस्यता 1 रद्द कर दी. सिस्टम ने सदस्यता रद्द कर दी है. उदाहरण के लिए, बिलिंग की समस्या की वजह से 2. सदस्यता को नई सदस्यता 3 से बदल दिया गया था. डेवलपर ने सदस्यता रद्द कर दी है
userCancellationTimeMillis	string (int64 format) वह समय, जब उपयोगकर्ता ने सदस्यता रद्द की थी. यह समय, युग की शुरुआत से लेकर अब तक के मिलीसेकंड में होता है. यह जानकारी सिर्फ़ तब दिखती है, जब cancelReason 0 पर सेट हो.
cancelSurveyResult	object (SubscriptionCancelSurveyResult) सदस्यता रद्द करने की प्रोसेस पूरी करते समय, उपयोगकर्ता की ओर से दी गई जानकारी (सदस्यता रद्द करने की वजह बताने वाला सर्वे).
orderId	string सदस्यता की खरीदारी से जुड़ा, बार-बार होने वाले ऑर्डर का सबसे नया ऑर्डर आईडी. अगर पेमेंट अस्वीकार होने की वजह से सदस्यता रद्द कर दी गई थी, तो यह पेमेंट अस्वीकार होने वाले ऑर्डर का आईडी होगा.
linkedPurchaseToken	string अगर यह सदस्यता इनमें से कोई एक है, तो मूल खरीदारी का टोकन: 0. रद्द की गई लेकिन खत्म नहीं हुई सदस्यता के लिए फिर से साइन अप करना 1. पिछली सदस्यता को अपग्रेड या डाउनग्रेड करना उदाहरण के लिए, मान लें कि कोई उपयोगकर्ता साइन अप करता है और आपको खरीदारी का टोकन X मिलता है. इसके बाद, उपयोगकर्ता सदस्यता रद्द कर देता है और सदस्यता खत्म होने से पहले, फिर से साइन अप करने की प्रोसेस पूरी करता है. इस दौरान, आपको खरीदारी का टोकन Y मिलता है. आखिर में, उपयोगकर्ता अपनी सदस्यता अपग्रेड करता है और आपको खरीदारी का टोकन Z मिलता है. अगर आपने इस एपीआई को खरीदारी के टोकन Z के साथ कॉल किया है, तो इस फ़ील्ड को Y पर सेट किया जाएगा. अगर आपने खरीदारी के टोकन Y के साथ इस एपीआई को कॉल किया है, तो इस फ़ील्ड को X पर सेट किया जाएगा. अगर आपने इस एपीआई को X परचेज़ टोकन के साथ कॉल किया है, तो यह फ़ील्ड सेट नहीं होगा.
purchaseType	integer सदस्यता किस तरह से खरीदी गई है. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब यह खरीदारी, ऐप्लिकेशन में खरीदारी के स्टैंडर्ड बिलिंग फ़्लो का इस्तेमाल करके नहीं की गई हो. इसकी वैल्यू 0 हो सकती है. टेस्ट (यानी कि लाइसेंस टेस्टिंग खाते से खरीदा गया) 1. प्रमोशन (यानी कि प्रोमो कोड का इस्तेमाल करके खरीदी गई)
priceChange	object (SubscriptionPriceChange) कीमत में हाल ही में हुए बदलाव की जानकारी उपलब्ध है. यह विकल्प सिर्फ़ तब दिखता है, जब सदस्यता के शुल्क में बदलाव होने वाला हो और उसे लागू न किया गया हो. नई कीमत पर सदस्यता रिन्यू होने या सदस्यता रद्द होने के बाद, कीमत में बदलाव की कोई जानकारी नहीं मिलेगी.
profileName	string सदस्यता खरीदते समय उपयोगकर्ता की प्रोफ़ाइल का नाम. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद होता है.
emailAddress	string सदस्यता खरीदते समय उपयोगकर्ता का ईमेल पता. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद होता है.
givenName	string सदस्यता खरीदते समय उपयोगकर्ता का दिया गया नाम. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद होता है.
familyName	string सदस्यता खरीदते समय उपयोगकर्ता का उपनाम. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद होता है.
profileId	string सदस्यता खरीदते समय, उपयोगकर्ता का Google प्रोफ़ाइल आईडी. यह सिर्फ़ 'Subscribe with Google' से की गई खरीदारी के लिए मौजूद होता है.
acknowledgementState	integer सदस्यता वाले प्रॉडक्ट की पुष्टि की स्थिति. इसकी वैल्यू 0 हो सकती है. अभी तक स्वीकार नहीं किया गया 1. स्वीकृत
externalAccountId	string तीसरे पक्ष की सेवा में उपयोगकर्ता खाते का आइडेंटिफ़ायर. यह सिर्फ़ तब दिखेगा, जब सदस्यता खरीदने की प्रोसेस के दौरान खाता लिंक किया गया हो.
promotionType	integer इस खरीदारी पर लागू किए गए प्रमोशन का टाइप. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब सदस्यता खरीदते समय कोई प्रमोशन लागू किया गया हो. इसकी वैल्यू 0 हो सकती है. एक बार इस्तेमाल किया जा सकने वाला कोड 1. वैनिटी कोड
promotionCode	string इस खरीदारी पर लागू किया गया प्रोमो कोड. यह फ़ील्ड सिर्फ़ तब सेट होता है, जब सदस्यता खरीदते समय वैनिटी कोड प्रमोशन लागू किया गया हो.
obfuscatedExternalAccountId	string यह आईडी का ऐसा वर्शन है जिसे छिपाया गया है. यह आपके ऐप्लिकेशन में उपयोगकर्ता के खाते से यूनीक तरीके से जुड़ा होता है. यह आईडी इन खरीदारी के लिए मौजूद होता है: * अगर खाता लिंक करने की प्रोसेस, सदस्यता खरीदने के फ़्लो के दौरान हुई हो. * खरीदारी करते समय, इसे https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid का इस्तेमाल करके सेट किया गया था.
obfuscatedExternalProfileId	string यह आईडी का ऐसा वर्शन है जिसे छिपाया गया है. यह आपके ऐप्लिकेशन में उपयोगकर्ता की प्रोफ़ाइल से यूनीक तरीके से जुड़ा होता है. यह सिर्फ़ तब मौजूद होता है, जब खरीदारी करते समय https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid का इस्तेमाल किया गया हो.

IntroductoryPriceInfo

इस कुकी में, सदस्यता की शुरुआती कीमत की जानकारी होती है.

JSON के काेड में दिखाना
{ "introductoryPriceCurrencyCode": string, "introductoryPriceAmountMicros": string, "introductoryPricePeriod": string, "introductoryPriceCycles": integer }

फ़ील्ड
introductoryPriceCurrencyCode	string सदस्यता के लिए शुरुआती कीमत का ISO 4217 मुद्रा कोड. उदाहरण के लिए, अगर कीमत ब्रिटिश पाउंड स्टर्लिंग में दी गई है, तो priceCurrencyCode "GBP" होगा.
introductoryPriceAmountMicros	string (int64 format) सदस्यता की शुरुआती कीमत, जिसमें टैक्स शामिल नहीं है. मुद्रा, priceCurrencyCode के जैसी है. कीमत को माइक्रो-यूनिट में दिखाया जाता है. यहां 1, 000,000 माइक्रो-यूनिट,मुद्रा की एक यूनिट के बराबर होता है. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMicros 1990000 होगा.
introductoryPricePeriod	string ISO 8601 फ़ॉर्मैट में बताई गई शुरुआती कीमत की अवधि. आम तौर पर इस्तेमाल होने वाली वैल्यू ये हैं, लेकिन इनके अलावा और भी वैल्यू इस्तेमाल की जा सकती हैं: "P1W" (एक हफ़्ता), "P1M" (एक महीना), "P3M" (तीन महीने), "P6M" (छह महीने), और "P1Y" (एक साल).
introductoryPriceCycles	integer शुरुआती कीमत ऑफ़र करने के लिए बिलिंग अवधि की संख्या.

SubscriptionCancelSurveyResult

सदस्यता रद्द करने की प्रोसेस पूरी करते समय, उपयोगकर्ता की ओर से दी गई जानकारी (सदस्यता रद्द करने की वजह बताने वाला सर्वे).

JSON के काेड में दिखाना
{ "cancelSurveyReason": integer, "userInputCancelReason": string }

फ़ील्ड
cancelSurveyReason	integer सदस्यता रद्द करने की वह वजह जो उपयोगकर्ता ने सर्वे में चुनी थी. इसकी वैल्यू 0 हो सकती है. अन्य 1. यह सेवा मेरे लिए बहुत ज़्यादा काम की नहीं है 2. तकनीकी समस्याएं 3. कीमत से जुड़ी वजहें 4. मुझे एक बेहतर ऐप्लिकेशन मिला है
userInputCancelReason	string उपयोगकर्ता की ओर से, इनपुट रद्द करने की वजह. यह सिर्फ़ तब मौजूद होता है, जब cancelReason 0 हो.

SubscriptionPriceChange

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

JSON के काेड में दिखाना
{ "newPrice": { object (Price) }, "state": integer }

फ़ील्ड
newPrice	object (Price) अगर उपयोगकर्ता ने कीमत में हुए बदलाव को स्वीकार कर लिया है, तो सदस्यता इस नई कीमत पर रिन्यू होगी.
state	integer कीमत में बदलाव की मौजूदा स्थिति. इसकी वैल्यू 0 हो सकती है. बकाया: यह शुल्क में होने वाले ऐसे बदलाव की स्थिति होती है जिसे उपयोगकर्ता की सहमति मिलना बाकी है. इस स्थिति में, ऐप्लिकेशन में मौजूद एपीआई का इस्तेमाल करके, उपयोगकर्ता से पुष्टि करने का अनुरोध किया जा सकता है. 1. स्वीकार किया गया: कीमत में हुए बदलाव को स्वीकार करने की स्थिति. इस स्थिति में, सदस्यता उसी कीमत पर रिन्यू होगी. हालांकि, ऐसा तब तक होगा, जब तक सदस्यता रद्द नहीं की जाती. कीमत में बदलाव, सदस्यता रिन्यू होने की तारीख से लागू होता है. ध्यान दें कि सदस्यता के अगले रिन्यूअल पर, यह बदलाव लागू नहीं हो सकता.

तरीके
acknowledge	यह कुकी, सदस्यता खरीदने की पुष्टि करती है.
cancel	उपयोगकर्ता की सदस्यता की खरीदारी रद्द करता है.
defer	यह कुकी, उपयोगकर्ता की सदस्यता खरीदने की प्रोसेस को तब तक के लिए रोक देती है, जब तक कि सदस्यता की समयसीमा खत्म होने का समय नहीं आ जाता.
get (deprecated)	इस्तेमाल बंद कर दिया गया है: इसके बजाय, purchases.subscriptionsv2.get का इस्तेमाल करें.
refund (deprecated)	इस्तेमाल बंद कर दिया गया है: इसके बजाय, orders.refund का इस्तेमाल करें.
revoke (deprecated)	इस्तेमाल बंद कर दिया गया है: इसके बजाय, purchases.subscriptionsv2.revoke का इस्तेमाल करें.

गड़बड़ी के कोड

इस संसाधन के ऑपरेशन, यहां दिए गए एचटीटीपी गड़बड़ी कोड दिखाते हैं:

गड़बड़ी का कोड	कारण	रिज़ॉल्यूशन
5xx	Google Play सर्वर में सामान्य गड़बड़ी.	अनुरोध को फिर से भेजें. अगर समस्या बनी रहती है, तो अपने Google Play खाता मैनेजर से संपर्क करें या सहायता का अनुरोध सबमिट करें. अगर आपको किसी समस्या के बारे में पहले से पता है, तो Play का स्टेटस डैशबोर्ड देखें.
409	एक साथ कई अपडेट करने पर गड़बड़ी हुई. किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे पहले से ही अपडेट किया जा रहा है. उदाहरण के लिए, Play Billing Library के acknowledgePurchase() तरीके को कॉल करके और Play Developer API के purchases.products.acknowledge को एक साथ कॉल करके, खरीदारी की पुष्टि की जा रही है.	अनुरोध को फिर से भेजें.
410	सदस्यता खरीदने की सुविधा अब क्वेरी के लिए उपलब्ध नहीं है, क्योंकि इसकी समयसीमा बहुत पहले खत्म हो चुकी है.	यह गड़बड़ी तब दिखती है, जब ऐसी सदस्यता के बारे में क्वेरी की जाती है जिसकी समयसीमा 60 दिनों से ज़्यादा समय पहले खत्म हो गई हो. अब आपको इन सदस्यताओं के बारे में क्वेरी नहीं करनी चाहिए.