REST Resource: purchases.subscriptionsv2

संसाधन: SubscriptionPurchaseV2

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

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}
फ़ील्ड
kind

string

यह प्रकार androidpublisher सेवा में SubscriptionPurchaseV2 ऑब्जेक्ट के बारे में बताता है.
regionCode

string

सदस्यता देते समय, उपयोगकर्ता का ISO 3166-1 alpha-2 बिलिंग देश/क्षेत्र कोड.
lineItems[]

object (SubscriptionPurchaseLineItem)

किसी सदस्यता की खरीदारी के लिए आइटम-लेवल की जानकारी. एक ही खरीदारी में शामिल सभी आइटम Auto RenewingPlan या प्रीपेड Plan के साथ होने चाहिए.
startTime

string (Timestamp format)

वह समय जब सदस्यता दी गई थी. 'मंज़ूरी बाकी है' सदस्यताओं के लिए सेट नहीं है (सदस्यता बनाई गई थी, लेकिन साइनअप के दौरान पेमेंट का इंतज़ार किया जा रहा है).

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
subscriptionState

enum (SubscriptionState)

सदस्यता की मौजूदा स्थिति.
latestOrderId

string

सदस्यता की खरीदारी से जुड़े नए ऑर्डर का ऑर्डर आईडी. अपने-आप रिन्यू होने वाली सदस्यता के लिए, यह साइनअप ऑर्डर का ऑर्डर आईडी होता है. ऐसा तब होता है, जब उसे अभी तक रिन्यू नहीं किया गया हो या आखिरी बार-बार लागू होने वाला ऑर्डर आईडी (सफल, स्वीकार नहीं किया गया या अस्वीकार किया गया ऑर्डर) होता है. प्रीपेड सदस्यता के लिए, यह ऑर्डर आईडी है, जो क्वेरी किए गए खरीदारी टोकन से जुड़ा है.
linkedPurchaseToken

string

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

object (PausedStateContext)

रोकी गई सदस्यताओं के बारे में ज़्यादा जानकारी. यह सिर्फ़ तब मौजूद होता है, जब सदस्यता के लिए मौजूदा SubscriptionState SUBSCRIPTION_STATE_PAUT हो.
canceledStateContext

object (CanceledStateContext)

रद्द की गई सदस्यताओं के बारे में ज़्यादा जानकारी. यह सिर्फ़ तब दिखता है, जब सदस्यता के लिए मौजूदा SubscriptionState SUBSCRIPTION_STATE_CANCELED हो.
testPurchase

object (TestPurchase)

यह जानकारी सिर्फ़ तब दिखती है, जब यह सदस्यता, टेस्ट के तौर पर की गई खरीदारी है.
acknowledgementState

enum (AcknowledgementState)

सदस्यता की पुष्टि की स्थिति.
externalAccountIdentifiers

object (ExternalAccountIdentifiers)

तीसरे पक्ष की सेवा में उपयोगकर्ता खाते का आइडेंटिफ़ायर.
subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

'Subscribe with Google' सुविधा की मदद से की गई खरीदारी से जुड़ी उपयोगकर्ता की प्रोफ़ाइल.

SubscriptionState

यह जानकारी किन स्थितियों में हो सकती है, जैसे कि सदस्यता चालू है या रद्द कर दी गई है. सदस्यता की खरीदारी में शामिल आइटम, अपने-आप रिन्यू होने वाले सभी प्लान या प्रीपेड प्लान हो सकते हैं.

Enums
SUBSCRIPTION_STATE_UNSPECIFIED सदस्यता की स्थिति की जानकारी नहीं है.
SUBSCRIPTION_STATE_PENDING सदस्यता बनाई जा चुकी है, लेकिन साइनअप के दौरान पेमेंट का इंतज़ार है. इस स्थिति में, सभी आइटम के लिए पेमेंट नहीं किया जाता है.
SUBSCRIPTION_STATE_ACTIVE सदस्यता चालू है. - (1) अगर सदस्यता अपने-आप रिन्यू होने वाला प्लान है, तो कम से कम एक आइटम अपने-आप रिन्यू होने की सुविधा चालू है और उसकी समयसीमा खत्म नहीं हुई है. - (2) अगर सदस्यता प्रीपेड प्लान है, तो कम से कम एक आइटम की समयसीमा खत्म नहीं हुई है.
SUBSCRIPTION_STATE_PAUSED सदस्यता पर रोक लगा दी गई है. यह स्थिति सिर्फ़ तब उपलब्ध होती है, जब सदस्यता अपने-आप रिन्यू होने वाला प्लान हो. इस स्थिति में, सभी आइटम 'रोका गया' की स्थिति में होते हैं.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD सदस्यता ग्रेस पीरियड में है. यह स्थिति सिर्फ़ तब उपलब्ध होती है, जब सदस्यता अपने-आप रिन्यू होने वाला प्लान हो. इस स्थिति में, सभी आइटम ग्रेस पीरियड में होते हैं.
SUBSCRIPTION_STATE_ON_HOLD सदस्यता पर रोक लगी है (निलंबित है). यह स्थिति सिर्फ़ तब उपलब्ध होती है, जब सदस्यता अपने-आप रिन्यू होने वाला प्लान हो. इस स्थिति में, सभी आइटम होल्ड पर रहते हैं.
SUBSCRIPTION_STATE_CANCELED सदस्यता रद्द कर दी गई है, लेकिन उसकी समयसीमा अभी खत्म नहीं हुई है. यह स्थिति सिर्फ़ तब उपलब्ध होती है, जब सदस्यता अपने-आप रिन्यू होने वाला प्लान हो. सभी आइटम के लिए, अपने-आप रिन्यू होने की सुविधा चालू है. यह 'गलत' पर सेट है.
SUBSCRIPTION_STATE_EXPIRED सदस्यता खत्म हो गई है. सभी आइटम की समयसीमा खत्म होने का समय बीत चुका है.

PausedStateContext

'रोके गए' स्टेटस वाली किसी सदस्यता की जानकारी.

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

string (Timestamp format)

वह समय जब सदस्यता अपने-आप फिर से शुरू हो जाएगी.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

CanceledStateContext

रद्द की गई सदस्यता की खास जानकारी.

जेएसओएन के काेड में दिखाना 
{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}
फ़ील्ड
यूनियन फ़ील्ड cancellation_reason. सदस्यता रद्द किए जाने की वजह. cancellation_reason इनमें से सिर्फ़ एक हो सकता है:
userInitiatedCancellation

object (UserInitiatedCancellation)

उपयोगकर्ता ने सदस्यता रद्द कर दी.
systemInitiatedCancellation

object (SystemInitiatedCancellation)

सिस्टम ने सदस्यता रद्द कर दी हो. उदाहरण के लिए, बिलिंग से जुड़ी किसी समस्या की वजह से.
developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

डेवलपर ने सदस्यता रद्द कर दी है.
replacementCancellation

object (ReplacementCancellation)

सदस्यता को नई सदस्यता से बदल दिया गया है.

UserInitiatedCancellation

उपयोगकर्ताओं की ओर से रद्द करने की प्रक्रिया के बारे में खास जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}
फ़ील्ड
cancelSurveyResult

object (CancelSurveyResult)

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

string (Timestamp format)

वह समय जब उपयोगकर्ता ने सदस्यता रद्द की थी. उपयोगकर्ता के पास इस अवधि के बाद भी सदस्यता का ऐक्सेस हो सकता है. यह पता लगाने के लिए कि उपयोगकर्ता के पास अब भी ऐक्सेस है या नहीं, LineItem.expiration_time का इस्तेमाल करें.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

CancelSurveyResult

उपयोगकर्ता के ज़रिए सदस्यता रद्द करने के दौरान हुए सर्वे का नतीजा.

जेएसओएन के काेड में दिखाना 
{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}
फ़ील्ड
reason

enum (CancelSurveyReason)

उपयोगकर्ता ने रद्द करने के सर्वे में जो वजह चुनी है.
reasonUserInput

string

केवल CANCEL_SURVEY_REASON_OTHERS के लिए सेट करें. यह सर्वे के लिए उपयोगकर्ता का बिना किसी शुल्क के दिया गया जवाब है.

CancelSurveyReason

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

Enums
CANCEL_SURVEY_REASON_UNSPECIFIED सर्वे रद्द करने की वजह नहीं बताई गई है.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE सदस्यता का पूरा इस्तेमाल नहीं हुआ है.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES ऐप्लिकेशन इस्तेमाल करते समय आने वाली तकनीकी समस्याएं.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP उपयोगकर्ता को एक बेहतर ऐप्लिकेशन मिल गया है.
CANCEL_SURVEY_REASON_OTHERS अन्य वजहें.

SystemInitiatedCancellation

इस टाइप के लिए कोई फ़ील्ड नहीं है.

Google सिस्टम की ओर से शुरू की गई रद्द करने की प्रक्रिया के बारे में जानकारी.

DeveloperInitiatedCancellation

इस टाइप के लिए कोई फ़ील्ड नहीं है.

रद्द करने की प्रक्रिया के बारे में डेवलपर की ओर से शुरू की गई जानकारी.

ReplacementCancellation

इस टाइप के लिए कोई फ़ील्ड नहीं है.

सदस्यता बदलने की वजह से रद्द होने वाली सदस्यताओं के बारे में जानकारी.

TestPurchase

इस टाइप के लिए कोई फ़ील्ड नहीं है.

क्या यह सदस्यता की खरीदारी, टेस्ट के तौर पर की गई खरीदारी है.

AcknowledgementState

किसी सदस्यता के लिए संभावित सहमति की स्थिति दिखती है.

Enums
ACKNOWLEDGEMENT_STATE_UNSPECIFIED सहमति की स्थिति की जानकारी नहीं है.
ACKNOWLEDGEMENT_STATE_PENDING सदस्यता को अभी तक स्वीकार नहीं किया गया है.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED सदस्यता स्वीकार की गई है.

ExternalAccountIdentifiers

तीसरे पक्ष की सेवा में उपयोगकर्ता खाते का आइडेंटिफ़ायर.

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

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 का इस्तेमाल करके बताया गया हो.

SubscribeWithGoogleInfo

'Subscribe with Google' सुविधा की मदद से की गई खरीदारी से जुड़ी जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
फ़ील्ड
profileId

string

Google पर उपयोगकर्ता का प्रोफ़ाइल आईडी, जब सदस्यता खरीदी गई थी.
profileName

string

उपयोगकर्ता की प्रोफ़ाइल का नाम, जब सदस्यता खरीदी गई थी.
emailAddress

string

उपयोगकर्ता का ईमेल पता, जब सदस्यता खरीदी गई थी.
givenName

string

सदस्यता खरीदते समय उपयोगकर्ता का दिया गया नाम.
familyName

string

उपयोगकर्ता के उस समय का नाम जब सदस्यता खरीदी गई थी.

SubscriptionPurchaseLineItem

किसी सदस्यता की खरीदारी के लिए आइटम-लेवल की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}
फ़ील्ड
productId

string

खरीदा गया प्रॉडक्ट आईडी (उदाहरण के लिए, 'month001').
expiryTime

string (Timestamp format)

वह समय जब ऐक्सेस की समयसीमा नहीं बढ़ाई जाती, जैसे कि सदस्यता रिन्यू होने पर, सदस्यता खत्म हो जाएगी या खत्म हो जाएगी.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
यूनियन फ़ील्ड plan_type. सदस्यता की योजना किस तरह की है. plan_type इनमें से सिर्फ़ एक हो सकता है:
autoRenewingPlan

object (AutoRenewingPlan)

यह आइटम अपने-आप रिन्यू होगा.
prepaidPlan

object (PrepaidPlan)

आइटम प्रीपेड है.
offerDetails

object (OfferDetails)

इस आइटम के लिए ऑफ़र की जानकारी.
यूनियन फ़ील्ड deferred_item_change. यह फ़ील्ड तब मौजूद होता है, जब किसी आइटम में कोई बदलाव रुक जाता है. इसे हटाया या बदला जा सकता है. deferred_item_change इनमें से सिर्फ़ एक हो सकता है:
deferredItemReplacement

object (DeferredItemReplacement)

स्थगित आइटम बदलने की जानकारी.

AutoRenewingPlan

अपने-आप रिन्यू होने वाले प्लान से जुड़ी जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  }
}
फ़ील्ड
autoRenewEnabled

boolean

अगर सदस्यता फ़िलहाल अपने-आप रिन्यू होने के लिए सेट है, तो इसका मतलब है कि उपयोगकर्ता ने सदस्यता रद्द नहीं की है
priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

सदस्यता के लिए साइनअप करने के बाद से, किसी आइटम की पिछली कीमत में हुए बदलाव की जानकारी.

SubscriptionItemPriceChangeDetails

सदस्यता में मौजूद किसी आइटम की कीमत में हुए बदलाव की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}
फ़ील्ड
newPrice

object (Money)

सदस्यता वाले आइटम के लिए, बार-बार लागू होने वाली नई कीमत.
priceChangeMode

enum (PriceChangeMode)

कीमत में बदलाव मोड से पता चलता है कि सदस्यता आइटम की कीमत में क्या बदलाव हो रहा है.
priceChangeState

enum (PriceChangeState)

बताएं कि कीमत में बदलाव अभी लागू है.
expectedNewPriceChargeTime

string (Timestamp format)

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

PriceChangeMode

कीमत बदलने का मोड.

Enums
PRICE_CHANGE_MODE_UNSPECIFIED कीमत में बदलाव के मोड की जानकारी नहीं है. यह वैल्यू कभी सेट नहीं की जानी चाहिए.
PRICE_DECREASE अगर सदस्यता की कीमत कम हो रही है.
PRICE_INCREASE अगर सदस्यता की कीमत बढ़ रही है और उपयोगकर्ता को इसे स्वीकार करना है.
OPT_OUT_PRICE_INCREASE अगर ऑप्ट आउट मोड की वजह से सदस्यता की कीमत बढ़ रही है, तो:

PriceChangeState

कीमत में बदलाव की स्थिति.

Enums
PRICE_CHANGE_STATE_UNSPECIFIED कीमत में बदलाव की स्थिति की जानकारी नहीं है. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
OUTSTANDING कीमत में बदलाव के लिए उपयोगकर्ता की सहमति का इंतज़ार किया जा रहा है.
CONFIRMED उपयोगकर्ता के लिए कीमत में बदलाव होने की पुष्टि हो गई है.
APPLIED बदली गई कीमत लागू कर दी गई है. इसका मतलब है कि उपयोगकर्ता से नई कीमत ली जाने लगी है.

PrepaidPlan

प्रीपेड प्लान के बारे में जानकारी.

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

string (Timestamp format)

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

OfferDetails

खरीदारी के लाइन आइटम के बारे में ऑफ़र की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}
फ़ील्ड
offerTags[]

string

ऑफ़र से जुड़े सबसे नए ऑफ़र टैग. इसमें बुनियादी प्लान से इनहेरिट किए गए टैग शामिल होते हैं.
basePlanId

string

बुनियादी प्लान का आईडी. सभी बुनियादी प्लान और ऑफ़र के लिए मौजूद.
offerId

string

ऑफ़र आईडी. यह सिर्फ़ छूट वाले ऑफ़र के लिए मौजूद है.

DeferredItemReplacement

स्थगित आइटम बदलने से जुड़ी जानकारी.

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

string

मौजूदा productId की जगह productId आ जाएगा.

तरीके

get

 किसी सदस्यता के बारे में मेटाडेटा पाना

revoke

 उपयोगकर्ता के लिए सदस्यता की खरीदारी को रद्द करना.