REST Resource: purchases.subscriptions

संसाधन: SubscriptionPurchase

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

जेएसओएन के काेड में दिखाना 
{
  "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)

सदस्यता की कीमत, जिन देशों में टैक्स शामिल नहीं है उनके लिए, कीमत में टैक्स शामिल नहीं होता. जिन देशों में टैक्स शामिल है उनके लिए, कीमत में टैक्स शामिल है. कीमत को माइक्रो-यूनिट में बताया जाता है, जहां 1,000,000 माइक्रो-यूनिट मुद्रा की एक इकाई को दिखाते हैं. उदाहरण के लिए, अगर सदस्यता की कीमत 1.99 यूरो है, तो priceAmountMicros 19,90,000 होगी.
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 के बाद के मिलीसेकंड में, वह समय जब उपयोगकर्ता ने सदस्यता को रद्द किया था. यह तब ही मौजूद होता है, जब cancel मंज़िल 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

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

जेएसओएन के काेड में दिखाना 
{
  "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 19,90,000 होगी.
introductoryPricePeriod

string

शुरुआती कीमत की अवधि, ISO 8601 फ़ॉर्मैट में दी गई है. सामान्य वैल्यू इस तरह हैं (इसमें इनके अलावा, और भी चीज़ें शामिल हो सकती हैं): "P1W" (एक हफ़्ता), "P1M" (एक महीना), "P3M" (तीन महीने), "P6M" (छह महीने), और "P1Y" (एक साल).
introductoryPriceCycles

integer

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

SubscriptionCancelSurveyResult

सदस्यता रद्द करने की प्रक्रिया पूरी करते समय उपयोगकर्ता से मिली जानकारी (सदस्यता रद्द करने की वजह से जुड़ा सर्वे).

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

integer

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

string

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

SubscriptionPriceChange

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

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

object (Price)

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

integer

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

तरीके

acknowledge

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

cancel

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

defer

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

get

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

refund

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

revoke

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