REST Resource: purchases.subscriptions

संसाधन: SubscriptionPurchase

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

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

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

string (int64 format)

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

object (IntroductoryPriceInfo)

सदस्यता की शुरुआती कीमत की जानकारी. ऐसा सिर्फ़ तब होता है, जब सदस्यता शुरुआती कीमत पर खरीदी गई हो.

यह फ़ील्ड नहीं बताता कि सदस्यता अभी शुरुआती कीमत की अवधि में है.
countryCode

string

जब सदस्यता दी गई थी, तब उपयोगकर्ता के देश/इलाके का कोड ISO 3166-1 alpha-2 फ़ॉर्मैट में होना चाहिए.
developerPayload

string

डेवलपर की ओर से तय की गई स्ट्रिंग, जिसमें किसी ऑर्डर के बारे में पूरक जानकारी होती है.
paymentState

integer

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

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

integer

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

string (int64 format)

Epoch के बाद, मिलीसेकंड में वह समय जब उपयोगकर्ता ने सदस्यता रद्द की थी. रद्द करने की वजह 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, दोनों एक ही हैं. कीमत को माइक्रो-यूनिट में दिखाया जाता है. यहां 10, 00,000 माइक्रो-यूनिट,मुद्रा की एक इकाई को दिखाते हैं. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMi Cros 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

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

SubscriptionPriceChange

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

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

object (Price)

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

integer

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

तरीके

acknowledge

 सदस्यता खरीदने को स्वीकार करता है.

cancel

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

defer

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

get

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

refund

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

revoke

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