REST Resource: purchases.subscriptions

संसाधन: सदस्यता खरीदना

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

जेएसओएन के काेड में दिखाना 
{
  "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 सेवा में सदस्यता खरीदारी ऑब्जेक्ट का प्रतिनिधित्व करता है.
startTimeMillis

string (int64 format)

उस समय से मिलती-जुलती अवधि के समय जब सदस्यता ली गई.
expiryTimeMillis

string (int64 format)

Epoch के बाद से सदस्यता की समयसीमा, मिलीसेकंड में खत्म हो जाएगी.
autoResumeTimeMillis

string (int64 format)

जिस अवधि के दौरान सदस्यता फिर से शुरू हो जाएगी वह मिलीसेकंड में होगी. अगर उपयोगकर्ता ने सदस्यता को रोकने का अनुरोध किया है, तभी मौजूद हो.
autoRenewing

boolean

सदस्यता, अपने-आप रिन्यू होने की सुविधा कब तक चलेगी, यह मौजूदा समय पर खत्म हो जाती है.
priceCurrencyCode

string

सदस्यता की कीमत के लिए ISO 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. बाकी पेमेंट 1. पेमेंट मिला 2. मुफ़्त में आज़माने की सुविधा 3. रुका हुआ अपग्रेड/डाउनग्रेड करना बाकी है

रद्द की गई, खत्म हो चुकी सदस्यताओं के लिए मौजूद नहीं है.
cancelReason

integer

सदस्यता रद्द होने या अपने-आप रिन्यू न होने की वजह. संभावित वैल्यू ये हैं: 0. उपयोगकर्ता ने सदस्यता 1 रद्द कर दी. सिस्टम में सदस्यता रद्द कर दी गई, उदाहरण के लिए, बिलिंग से जुड़ी समस्या 2. सदस्यता को नई सदस्यता 3 से बदला गया. डेवलपर ने सदस्यता रद्द कर दी थी
userCancellationTimeMillis

string (int64 format)

उपयोगकर्ता के ज़रिए सदस्यता रद्द करने का समय, एक खास अवधि से लेकर अब तक, मिलीसेकंड में. रद्द करने की वजह 0 होने पर ही मौजूद है.
cancelSurveyResult

object (SubscriptionCancelSurveyResult)

सदस्यता रद्द करने की प्रक्रिया पूरी करने पर, उपयोगकर्ता की दी गई जानकारी. इसमें, सदस्यता रद्द करने की वजह के बारे में सर्वे भी शामिल है.
orderId

string

सदस्यता खरीदने के साथ जुड़े, बार-बार होने वाले नए ऑर्डर का ऑर्डर आईडी. अगर सदस्यता अस्वीकार होने की वजह से सदस्यता रद्द की गई थी, तो यह ऑर्डर अस्वीकार किया जाएगा.
linkedPurchaseToken

string

अगर इस सदस्यता में से कोई एक शुरुआत होती है, तो मूल खरीदारी का खरीदारी टोकन: 0. रद्द की गई, लेकिन पूरी नहीं हुई सदस्यता 1 के लिए फिर से साइन अप. पिछली सदस्यता पर अपग्रेड या डाउनग्रेड करना

उदाहरण के लिए, मान लें कि उपयोगकर्ता को शुरुआत में साइन अप किया जाता है और आपको खरीदारी टोकन X मिलता है. इसके बाद, उपयोगकर्ता उसे रद्द करता है और उसे फिर से साइन अप करने की प्रक्रिया (अपनी सदस्यता खत्म होने से पहले) करता है. साथ ही, आपको खरीदारी टोकन Y मिलती है और आखिर में, उपयोगकर्ता अपनी सदस्यता अपग्रेड करता है और आपको खरीदारी टोकन Z मिलता है. अगर इस एपीआई को कॉल टोकन Z के साथ कॉल किया जाता है, तो इस फ़ील्ड को Y पर सेट कर दिया जाएगा. अगर आप इस API को खरीदारी टोकन Y के साथ कॉल करते हैं, तो यह फ़ील्ड X पर सेट हो जाएगा. अगर आप इस API को खरीदारी टोकन 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/PlayFlowParams.Builder#setobfuscatedaccountid का इस्तेमाल करके इसे बताया गया था.
obfuscatedExternalProfileId

string

आपके ऐप्लिकेशन में, उपयोगकर्ता के प्रोफ़ाइल से खास तौर पर आईडी का, अस्पष्ट वर्शन. यह जानकारी तब ही उपलब्ध होगी, जब खरीदारी के समय https://developer.android.com/reference/com/android/billingclient/api/PlayFlowParams.Builder#setobfuscatedprofileid का इस्तेमाल किया गया हो.

शुरुआती कीमत की जानकारी

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

जेएसओएन के काेड में दिखाना 
{
  "introductoryPriceCurrencyCode": string,
  "introductoryPriceAmountMicros": string,
  "introductoryPricePeriod": string,
  "introductoryPriceCycles": integer
}
फ़ील्ड
introductoryPriceCurrencyCode

string

शुरुआती सदस्यता की कीमत के लिए ISO 4217 मुद्रा कोड. जैसे, अगर कीमत ब्रिटिश पाउंड स्टर्लिंग में दी गई है, तो priceCurrencyCode "GBP" है.
introductoryPriceAmountMicros

string (int64 format)

सदस्यता की शुरुआती कीमत. इसमें टैक्स शामिल नहीं है. मुद्रा, priceCurrencyCode के जैसी है. कीमत को माइक्रो-यूनिट में दिखाया जाता है. इसमें 10, 00,000 माइक्रो-यूनिट,मुद्रा की एक इकाई के बारे में बताती हैं. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMicros की वैल्यू 1990000 है.
introductoryPricePeriod

string

शुरुआती कीमत की अवधि, ISO 8601 फ़ॉर्मैट में. आम तौर पर, वैल्यू का इस्तेमाल किया जा सकता है. हालांकि, इनमें कोटेशन और P1M" (एक महीना), "P3M" (तीन महीने), और &P6Y" (छह महीने), और "P1Y" (एक साल शामिल है) शामिल हैं.
introductoryPriceCycles

integer

शुरुआती कीमत ऑफ़र करने के लिए बिलिंग अवधि की संख्या.

सदस्यता रद्द करने से जुड़ा सर्वे का नतीजा

सदस्यता रद्द करने की प्रक्रिया पूरी करने पर, उपयोगकर्ता की दी गई जानकारी. इसमें, सदस्यता रद्द करने की वजह के बारे में सर्वे भी शामिल है.

जेएसओएन के काेड में दिखाना 
{
  "cancelSurveyReason": integer,
  "userInputCancelReason": string
}
फ़ील्ड
cancelSurveyReason

integer

उपयोगकर्ता के ज़रिए सर्वे में रद्द करने की वजह. संभावित वैल्यू ये हैं: 0. अन्य 1. मैं इस सेवा का बहुत ज़्यादा इस्तेमाल नहीं करता 2. तकनीकी समस्याएं 3. लागत से जुड़ी वजहें 4. मुझे एक बेहतर ऐप्लिकेशन मिला है
userInputCancelReason

string

पसंद के मुताबिक बनाया गया इनपुट, उपयोगकर्ता की वजह से रद्द हो गया है. रद्द करने की वजह 0 होने पर ही मौजूद है.

सदस्यता की कीमत में बदलाव

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

जेएसओएन के काेड में दिखाना 
{
  "newPrice": {
    object (Price)
  },
  "state": integer
}
फ़ील्ड
newPrice

object (Price)

अगर उपयोगकर्ता ने कीमत में बदलाव स्वीकार किया, तो नई कीमत रिन्यू हो जाएगी.
state

integer

कीमत में बदलाव की मौजूदा स्थिति. संभावित वैल्यू ये हैं: 0. बकाया: उपयोगकर्ता की सहमति के लिए, कीमत में हुए बदलाव की स्थिति. इस स्थिति में, आप इन-ऐप्लिकेशन एपीआई का इस्तेमाल करके उपयोगकर्ता से पुष्टि करने का विकल्प चुन सकते हैं. 1. स्वीकार किया गया: स्वीकार किए गए कीमत में हुए बदलाव के बारे में जानकारी. इसे तब तक रिन्यू किया जाएगा, जब तक सदस्यता रद्द नहीं की जाती. कीमत में बदलाव आने वाले समय में लागू होता है, जब सदस्यता रिन्यू होती है. ध्यान दें कि सदस्यता को अगली बार रिन्यू करने पर, हो सकता है कि बदलाव न हो.

माटिंग में इस्तेमाल हुए तरीके

acknowledge

 सदस्यता खरीदने की पुष्टि करता है.

cancel

 उपयोगकर्ता की सदस्यता खरीदारी रद्द करता है.

defer

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

get

 यह जांचता है कि उपयोगकर्ता की सदस्यता खरीदारी मान्य है या नहीं और उसके खत्म होने का समय दिखाता है या नहीं.

refund

 उपयोगकर्ता की खरीदारी के लिए रिफ़ंड जारी करता है, लेकिन समयसीमा खत्म होने तक सदस्यता मान्य रहेगी और यह बार-बार होगी.

revoke

 रिफ़ंड और उपयोगकर्ता की सदस्यता खरीदारी को तुरंत रद्द कर देता है.