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
(deprecated)

boolean

सिर्फ़ आउटपुट के लिए. अब काम नहीं करता: सदस्यता को संग्रहित करने की सुविधा काम नहीं करती.
taxAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

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

BasePlan

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

जेएसओएन के काेड में दिखाना 
{
  "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 इसे नई जगहों पर लॉन्च कर सकता है.
यूनियन फ़ील्ड base_plan_type. यह बुनियादी प्लान किस तरह का है. सटीक एक को सेट करना होगा. base_plan_type इनमें से सिर्फ़ एक हो सकती है:
autoRenewingBasePlanType

object (AutoRenewingBasePlanType)

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

object (PrepaidBasePlanType)

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

स्थिति

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

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

AutoRenewingBasePlanType

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

जेएसओएन के काेड में दिखाना 
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "accountHoldDuration": 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 दिन). अगर इसके लिए कोई वैल्यू तय नहीं की गई है, तो बार-बार लगने वाली अवधि के आधार पर एक डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा.
accountHoldDuration

string

ज़रूरी नहीं. सदस्यता लेने के लिए खाते पर रोक लगाने की अवधि, जो ISO 8601 फ़ॉर्मैट में दी गई है. स्वीकार्य मान DAYS में और P0D (शून्य दिन) से P30D (30 दिन) की सीमा में होने चाहिए. अगर इसके लिए कोई तय नहीं किया गया है, तो डिफ़ॉल्ट वैल्यू P30D (30 दिन) होती है.
resubscribeState

enum (ResubscribeState)

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

enum (SubscriptionProrationMode)

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

boolean

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

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

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

string

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

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

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

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

ResubscribeState

बुनियादी प्लान फिर से सदस्यता लेने की स्थिति.

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 उपयोगकर्ताओं से उनके नए बुनियादी प्लान के लिए, तुरंत और पूरा शुल्क लिया जाएगा. मौजूदा सदस्यता के बचे हुए समय का इस्तेमाल, नए बिलिंग प्लान की अवधि को बढ़ाने के लिए किया जाएगा.

PrepaidBasePlanType

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

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

string

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

enum (TimeExtension)

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

TimeExtension

बुनियादी प्लान की अवधि बढ़ाई गई.

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

RegionalBasePlanConfig

किसी इलाके के हिसाब से बुनियादी प्लान का कॉन्फ़िगरेशन.

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

string

ज़रूरी है. वह क्षेत्र कोड जिस पर यह कॉन्फ़िगरेशन लागू होता है, जैसा कि ISO 3166-2 के मुताबिक तय किया गया है, जैसे कि "US".
newSubscriberAvailability

boolean

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

object (Money)

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

OtherRegionsBasePlanConfig

उन सभी नए जगहों की कीमत की जानकारी जहां Play लॉन्च हो सकता है.

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

object (Money)

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

object (Money)

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

boolean

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

SubscriptionListing

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

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

string

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

string

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

string

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

string

इस स्टोर पेज की भाषा में इस सदस्यता का ब्यौरा. ज़्यादा से ज़्यादा 80 वर्ण इस्तेमाल किए जा सकते हैं. सादा टेक्स्ट.

तरीके

archive
(deprecated)

 अब काम नहीं करता: सदस्यता को संग्रहित करने की सुविधा काम नहीं करती.

batchGet

 एक या उससे ज़्यादा सदस्यताओं को पढ़ता है.

batchUpdate

 सदस्यताओं के बैच को अपडेट करता है.

create

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

delete

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

get

 एक सदस्यता को पढ़ता है.

list

 यह किसी ऐप्लिकेशन में मौजूद सभी सदस्यताओं की सूची दिखाता है.

patch

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