REST Resource: monetization.subscriptions

संसाधन: सदस्यता

किसी ऐप्लिकेशन के लिए एक सदस्यता.

जेएसओएन के काेड में दिखाना 
{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}
फ़ील्ड
packageName

string

नहीं बदले जा सकते. पैरंट ऐप्लिकेशन का पैकेज नाम.
productId

string

नहीं बदले जा सकते. प्रॉडक्ट का यूनीक प्रॉडक्ट आईडी. पैरंट ऐप्लिकेशन में खास. प्रॉडक्ट आईडी में अंग्रेज़ी के छोटे अक्षर (a-z), संख्याएं (0-9), अंडरस्कोर (_), और बिंदु (.), अंग्रेज़ी के छोटे अक्षर या संख्या से शुरू होने चाहिए और उनकी लंबाई 1 से 40 के बीच होनी चाहिए.
basePlans[]

object (BasePlan)

इस सदस्यता के लिए बुनियादी प्लान का सेट. सदस्यता के शुल्क और अवधि को तब दिखाता है, जब कोई और ऑफ़र लागू न हो.
listings[]

object (SubscriptionListing)

ज़रूरी है. इस सदस्यता के लिए, लोकलाइज़ की गई लिस्टिंग की सूची. इसमें पैरंट ऐप्लिकेशन की डिफ़ॉल्ट भाषा के लिए, कम से कम एक एंट्री होनी चाहिए.
archived

boolean

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

object (SubscriptionTaxAndComplianceSettings)

टैक्स और कानूनी अनुपालन के बारे में जानकारी.

बुनियादी प्लान

सदस्यता के लिए सिंगल बुनियादी प्लान.

जेएसओएन के काेड में दिखाना 
{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}
फ़ील्ड
basePlanId

string

ज़रूरी है. नहीं बदले जा सकते. इस बुनियादी प्लान का यूनीक आइडेंटिफ़ायर. सदस्यता के भीतर अद्वितीय होना चाहिए और RFC-1034 का पालन करना चाहिए. इसका मतलब है कि इस आईडी में, सिर्फ़ अंग्रेज़ी के छोटे अक्षर (a-z), संख्याएं (0-9), और हाइफ़न (-) हो सकते हैं. इसके अलावा, इसमें ज़्यादा से ज़्यादा 63 वर्ण हो सकते हैं.
state

enum (State)

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

object (RegionalBasePlanConfig)

इलाके के हिसाब से, इस बुनियादी प्लान के बारे में जानकारी.
offerTags[]

object (OfferTag)

इस बुनियादी प्लान के लिए ज़्यादा से ज़्यादा 20 कस्टम टैग की सूची दी गई है और बिलिंग लाइब्रेरी के ज़रिए ऐप्लिकेशन पर वापस भेजे गए हैं. इस बुनियादी प्लान की सदस्यता के ऑफ़र के लिए 'बिलिंग लाइब्रेरी' में भी ये ऑफ़र टैग मिलेंगे.
otherRegionsConfig

object (OtherRegionsBasePlanConfig)

आने वाले समय में, Play ऐसी नई जगहों के लिए कीमत की जानकारी लॉन्च कर सकता है जहां Play लॉन्च हो सकता है. अगर इसे हटा दिया जाता है, तो आने वाले समय में Google Play के लॉन्च किए जा सकने वाली जगहों में, बुनियादी प्लान अपने-आप उपलब्ध नहीं होगा.
यूनियन फ़ील्ड base_plan_type. इस बुनियादी प्लान का टाइप. बिलकुल एक सेट करना होगा. base_plan_type इनमें से सिर्फ़ एक हो सकता है:
autoRenewingBasePlanType

object (AutoRenewingBasePlanType)

बुनियादी प्लान के अपने-आप रिन्यू होने का समय, समय-समय पर सेट करें.
prepaidBasePlanType

object (PrepaidBasePlanType)

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

स्थिति

बुनियादी प्लान की मौजूदा स्थिति.

Enums
STATE_UNSPECIFIED अनिर्दिष्ट राज्य.
DRAFT फ़िलहाल, बुनियादी प्लान ड्राफ़्ट स्थिति में है और उसे चालू नहीं किया गया है. इस पॉइंट को सुरक्षित तरीके से मिटाया जा सकता है.
ACTIVE बुनियादी प्लान चालू है और नए सदस्यों के लिए उपलब्ध है.
INACTIVE बुनियादी प्लान बंद है और सिर्फ़ मौजूदा सदस्यों को मिल सकता है.

अपने-आप रिन्यू होने वाले बुनियादी प्लान का प्रकार

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

जेएसओएन के काेड में दिखाना 
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}
फ़ील्ड
billingPeriodDuration

string

ज़रूरी है. सदस्यता अवधि, ISO 8601 फ़ॉर्मैट में है. सही बिलिंग अवधि के लिए, सहायता केंद्र देखें.
gracePeriodDuration

string

सदस्यता की छूट की अवधि, ISO 8601 फ़ॉर्मैट में दी गई है. स्वीकार की जाने वाली वैल्यू P0D (शून्य दिन), P3D (3 दिन), P7D (7 दिन), P14D (14 दिन), और P30D (30 दिन) हैं. अगर जानकारी नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल, बार-बार होने वाली अवधि के आधार पर किया जाएगा.
resubscribeState

enum (ResubscribeState)

यह ज़रूरी है कि उपयोगकर्ता, Google Play के प्लैटफ़ॉर्म पर इस बुनियादी प्लान की सदस्यता फिर से ले सकें. अगर कुछ भी न बताया गया हो, तो डिफ़ॉल्ट तौर पर REसदस्य के नाम में REसदस्य के रूप में हो सकता है END_STATE_ACTIVE.
prorationMode

enum (SubscriptionProrationMode)

बुनियादी प्लान के लिए प्रोरेशन मोड से यह तय होता है कि जब कोई उपयोगकर्ता, किसी दूसरे बुनियादी प्लान से स्विच करता है, तो क्या होता है. अगर जानकारी नहीं दी जाती है, तो डिफ़ॉल्ट रूप से, CHARGE_ON_Next_Billing_DATE को सेट की जाएगी.
legacyCompatible

boolean

रिन्यू हो रहा बुनियादी प्लान, पुराने सिस्टम के साथ काम करता है या नहीं.

पुराने सिस्टम के साथ काम करने वाले बुनियादी प्लान को दिखाने के लिए, 'Google Play Billing लाइब्रेरी' के querySkuDetailsAsync() तरीके का इस्तेमाल किया जाता है, जो अब उपलब्ध नहीं है.

किसी सदस्यता के लिए, रिन्यू हो रहे सिर्फ़ एक बुनियादी प्लान को 'Play Billing लाइब्रेरी' के पुराने वर्शन के साथ काम करने के लिए मार्क किया जा सकता है.
legacyCompatibleSubscriptionOfferId

string

सदस्यता ऑफ़र आईडी, जो लेगसी वर्शन के साथ काम करता है.

पुराने सिस्टम के साथ काम करने की सदस्यता का ऑफ़र तब दिखाया जाएगा, जब 'Google Play Billing लाइब्रेरी' के querySkuDetailsAsync() तरीके का इस्तेमाल किया जाएगा, जो अब उपलब्ध नहीं है.

रिन्यू किए जा रहे किसी बुनियादी प्लान के लिए, सिर्फ़ एक सदस्यता ऑफ़र को 'Play Billing लाइब्रेरी' के पुराने वर्शन के साथ काम करने के लिए मार्क किया जा सकता है.

अगर पुराने सदस्यता के साथ काम करने के लिए, सदस्यता का कोई ऑफ़र नहीं है, तो इस फ़ील्ड को खाली स्ट्रिंग के तौर पर सेट करें.

फिर से सदस्यता लें

बुनियादी प्लान फिर से सदस्यता की स्थिति में आ गया है.

Enums
RESUBSCRIBE_STATE_UNSPECIFIED अनिर्दिष्ट राज्य.
RESUBSCRIBE_STATE_ACTIVE फिर से सदस्यता ली जा रही है.
RESUBSCRIBE_STATE_INACTIVE फिर से सदस्यता लेने की सुविधा बंद है.

SubscriptionProrationMode

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

Enums
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED अनजान मोड.
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE मौजूदा बिलिंग अवधि खत्म होने पर, उपयोगकर्ताओं से उनके नए बुनियादी प्लान के लिए शुल्क लिया जाएगा.
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY उपयोगकर्ताओं से उनके नए बुनियादी प्लान के लिए तुरंत और पूरी रकम ली जाएगी. नए प्लान की अवधि बढ़ाने के लिए, मौजूदा सदस्यता की बची हुई अवधि का इस्तेमाल किया जाएगा.

प्रीपेडबुनियादी प्लान का प्रकार

यह ऐसे बुनियादी प्लान के बारे में बताता है जो बुनियादी प्लान के आखिर में अपने-आप रिन्यू नहीं होता. इसे मैन्युअल तरीके से भी उपयोगकर्ता को रिन्यू करना होगा.

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

string

ज़रूरी है. सदस्यता अवधि, ISO 8601 फ़ॉर्मैट में है. सही बिलिंग अवधि के लिए, सहायता केंद्र देखें.
timeExtension

enum (TimeExtension)

उपयोगकर्ता, Google Play के प्लैटफ़ॉर्म पर इस प्रीपेड बुनियादी प्लान की अवधि बढ़ा सकते हैं या नहीं. अगर खास तौर पर नहीं बताया गया है, तो डिफ़ॉल्ट रूप से,TIME_EXTENSION_ACTIVE पर सेट होते हैं.

टाइम एक्सटेंशन

बुनियादी प्लान का समय एक्सटेंशन.

Enums
TIME_EXTENSION_UNSPECIFIED अनिर्दिष्ट राज्य.
TIME_EXTENSION_ACTIVE समय एक्सटेंशन सक्रिय है. उपयोगकर्ताओं को अपने प्रीपेड प्लान को टॉप-अप करने या उसकी अवधि बढ़ाने की अनुमति है.
TIME_EXTENSION_INACTIVE समय एक्सटेंशन निष्क्रिय है. उपयोगकर्ता अपने प्रीपेड प्लान को टॉप-अप या बड़ा नहीं कर सकते हैं.

AreaBasePlanConfig

किसी खास क्षेत्र के लिए बुनियादी प्लान का कॉन्फ़िगरेशन.

जेएसओएन के काेड में दिखाना 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}
फ़ील्ड
regionCode

string

ज़रूरी है. यह इलाका कोड पर लागू होता है, जैसा कि ISO 3166-2 में बताया गया है. उदाहरण के लिए, "US".
newSubscriberAvailability

boolean

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

object (Money)

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

अन्य क्षेत्र के लिए बुनियादी प्लान का कॉन्फ़िगरेशन

Play किसी भी नई जगह के लिए कीमत की जानकारी लॉन्च कर सकता है.

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

object (Money)

ज़रूरी है. डॉलर में कीमत, जिसे किसी भी नई जगह पर Play के लॉन्च के लिए इस्तेमाल किया जा सकता है.
eurPrice

object (Money)

ज़रूरी है. Play Store में किसी भी नई जगह के लिए यूरो का इस्तेमाल करें.
newSubscriberAvailability

boolean

बुनियादी प्लान की सुविधा, नए सदस्यों के लिए उपलब्ध है या नहीं, अगर यह सुविधा किसी भी नई जगह पर उपलब्ध है, तो Play को लॉन्च किया जा सकता है. अगर इस नीति की जानकारी नहीं दी जाती है, तो यह डिफ़ॉल्ट रूप से 'गलत है' पर सेट होगी.

सदस्यता की सूची

सदस्यता का उपभोक्ता को दिखने वाला मेटाडेटा.

जेएसओएन के काेड में दिखाना 
{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}
फ़ील्ड
languageCode

string

ज़रूरी है. इस लिस्टिंग की भाषा, जैसा कि BCP-47 में बताया गया है, जैसे कि "en-US".
title

string

ज़रूरी है. इस लिस्टिंग की भाषा में इस सदस्यता का शीर्षक. सादा टेक्स्ट.
benefits[]

string

Play Store जैसे प्लैटफ़ॉर्म पर उपयोगकर्ता को दिखाए गए फ़ायदों की सूची. साथ ही, लिस्टिंग की भाषा में इसे पहले जैसा किया जाता है. सादा टेक्स्ट. ज़्यादा से ज़्यादा चार फ़ायदों की सूची बनाई गई.
description

string

इस स्टोर पेज की भाषा में इस सदस्यता की जानकारी. ज़्यादा से ज़्यादा - 80 वर्ण. सादा टेक्स्ट.

तरीके

archive

 सदस्यता को संग्रहित करता है.

create

 एक नई सदस्यता बनाता है.

delete

 सदस्यता को मिटाता है.

get

 सिर्फ़ एक सदस्यता पढ़ता है.

list

 इसमें किसी ऐप्लिकेशन की सभी सदस्यताएं दिखती हैं.

patch

 किसी मौजूदा सदस्यता को अपडेट करता है.