REST Resource: monetization.subscriptions.basePlans.offers

संसाधन: SubscriptionOffer

ऐसा ऑफ़र जो कुछ समय के लिए है

जेएसओएन के काेड में दिखाना 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}
फ़ील्ड
packageName

string

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

string

ज़रूरी है. इम्यूटेबल. उस पैरंट सदस्यता का आईडी जिसका यह ऑफ़र है.
basePlanId

string

ज़रूरी है. इम्यूटेबल. उस बुनियादी प्लान का आईडी जिसके लिए यह ऑफ़र, एक्सटेंशन के तौर पर इस्तेमाल किया जा रहा है.
offerId

string

ज़रूरी है. इम्यूटेबल. सदस्यता के इस ऑफ़र का यूनीक आईडी. यह बुनियादी प्लान में अलग होना चाहिए.
state

enum (State)

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

object (SubscriptionOfferPhase)

ज़रूरी है. सदस्यता के इस ऑफ़र के चरण. इसमें कम से कम एक एंट्री होनी चाहिए और ज़्यादा से ज़्यादा पांच हो सकते हैं. उपयोगकर्ताओं को ये सभी चरण, हमेशा तय किए गए क्रम में मिलेंगे. शुरुआती चरण बनाने के बाद, न तो फ़ेज़ जोड़े या हटाए जा सकते हैं और न ही उनका क्रम बदला जा सकता है.
targeting

object (SubscriptionOfferTargeting)

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

object (RegionalSubscriptionOfferConfig)

ज़रूरी है. इस ऑफ़र का देश/इलाके के हिसाब से कॉन्फ़िगरेशन. इसमें कम से कम एक एंट्री होनी चाहिए.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

आने वाले समय में, Play की किसी भी नई जगह का कॉन्फ़िगरेशन लॉन्च किया जा सकता है.
offerTags[]

object (OfferTag)

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

स्थिति

सदस्यता के ऑफ़र की मौजूदा स्थिति.

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

SubscriptionOfferPhase

सदस्यता के ऑफ़र का एक फ़ेज़.

जेएसओएन के काेड में दिखाना 
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
फ़ील्ड
recurrenceCount

integer

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

string

ज़रूरी है. इस चरण को एक बार दोहराने का समय. ISO 8601 फ़ॉर्मैट में बताया गया.
regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

ज़रूरी है. इस ऑफ़र के चरण का कॉन्फ़िगरेशन, देश/इलाके के हिसाब से तय होता है. इस सूची में, हर उस इलाके के लिए एक एंट्री होनी चाहिए जिसके लिए, सदस्यता के ऑफ़र का देश/इलाके के हिसाब से कॉन्फ़िगरेशन तय है.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

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

RegionalSubscriptionOfferPhaseConfig

किसी एक क्षेत्र में, सदस्यता के ऑफ़र के एक चरण के लिए कॉन्फ़िगरेशन.

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

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object
  }
  // End of list of possible types for union field price_override.
}
फ़ील्ड
regionCode

string

ज़रूरी है. इम्यूटेबल. वह क्षेत्र जहां यह कॉन्फ़िगरेशन लागू होता है.
यूनियन फ़ील्ड price_override. इस चरण के लिए कीमत में बदलाव. ज़रूरी है. price_override इनमें से सिर्फ़ एक हो सकती है:
price

object (Money)

वह कुल कीमत जो ऑफ़र के इस चरण के लिए, उपयोगकर्ता को चुकानी होती है. कीमत, इस क्षेत्र के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए.
relativeDiscount

number

ऑफ़र के इस चरण के लिए, उपयोगकर्ता के तय किए गए समय के दौरान, बुनियादी प्लान की कीमत का अनुपात. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए 50% की छूट, 1.50 डॉलर के बराबर होगी. छूट को ऐसे अंश के रूप में दिखाया जाना चाहिए जो 0 से बड़ा हो और 1 से कम हो. इससे मिलने वाली कीमत, बिल करने लायक नज़दीकी यूनिट में बदल दी जाएगी (जैसे कि डॉलर के लिए सेंट). अगर छूट वाली कीमत, इस क्षेत्र में स्वीकार की गई कम से कम कीमत से कम है, तो मिलती-जुलती छूट अमान्य माना जाएगा.
absoluteDiscount

object (Money)

ऑफ़र के इस चरण के लिए, उपयोगकर्ता के दिए जाने वाले चरण के हिसाब से, बुनियादी प्लान की कीमत में से घटाकर मिली कुल रकम. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल की अवधि के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट, दो डॉलर के बराबर होगी. यह कीमत, इस क्षेत्र के लिए तय की गई कम से कम कीमत से कम नहीं हो सकती.
free

object

यह बताने के लिए सेट करें कि यह ऑफ़र मुफ़्त में मिल सकता है.

OtherRegionsSubscriptionOfferPhaseConfig

उन नई जगहों के लिए कॉन्फ़िगरेशन जो Play को ऑफ़र के एक चरण में लॉन्च किया जा सकता है.

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

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object
  }
  // End of list of possible types for union field price_override.
}
फ़ील्ड
यूनियन फ़ील्ड price_override. इस चरण के लिए कीमत में बदलाव. ज़रूरी है. price_override इनमें से सिर्फ़ एक हो सकती है:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

वह कुल कीमत जो ऑफ़र के इस चरण के लिए, उपयोगकर्ता को चुकानी होती है. कीमत, उन नई जगहों के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए जहां Google Play को लॉन्च कर सकते हैं.
relativeDiscount

number

ऑफ़र के इस चरण के लिए, उपयोगकर्ता के तय किए गए समय के दौरान, बुनियादी प्लान की कीमत का अनुपात. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए 50% की छूट, 1.50 डॉलर के बराबर होगी. छूट को ऐसे अंश के रूप में दिखाया जाना चाहिए जो 0 से बड़ा हो और 1 से कम हो. इससे मिलने वाली कीमत, बिल करने लायक नज़दीकी यूनिट में बदल दी जाएगी (जैसे कि डॉलर के लिए सेंट). अगर छूट वाली कीमत, Google Play की नई जगहों पर लॉन्च की जा सकने वाली कम से कम कीमत से भी कम होती है, तो मिलती-जुलती छूट को अमान्य माना जाता है.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

ऑफ़र के इस चरण के लिए, उपयोगकर्ता के दिए जाने वाले चरण के हिसाब से, बुनियादी प्लान की कीमत में से घटाकर मिली कुल रकम. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल की अवधि के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट, दो डॉलर के बराबर होगी. यह कीमत, हो सकता है कि उन नई जगहों के लिए तय की गई कम से कम कीमत से कम न हो जहां Play को लॉन्च किया जा सकता है.
free

object

यह बताने के लिए सेट करें कि यह ऑफ़र मुफ़्त में मिल सकता है.

OtherRegionsSubscriptionOfferPhasePrices

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

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

object (Money)

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

object (Money)

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

SubscriptionOfferTargeting

वह नियम तय करता है जिसे उपयोगकर्ता को यह ऑफ़र पाने के लिए पूरा करना होगा.

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

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}
फ़ील्ड
यूनियन फ़ील्ड rule. डेवलपर की ओर से तय किए गए ऑफ़र की ज़रूरी शर्तों के बारे में जानने के लिए, इस फ़ील्ड को खाली छोड़ दें. rule इनमें से सिर्फ़ एक हो सकती है:
acquisitionRule

object (AcquisitionTargetingRule)

नए उपयोगकर्ता हासिल करने के लिए ऑफ़र टारगेटिंग का नियम.
upgradeRule

object (UpgradeTargetingRule)

उपयोगकर्ताओं के मौजूदा प्लान अपग्रेड करने के लिए, ऑफ़र टारगेटिंग का नियम.

AcquisitionTargetingRule

फ़ॉर्म का टारगेटिंग नियम दिखाता है: उपयोगकर्ता के पास पहले कभी {scope} नहीं था.

जेएसओएन के काेड में दिखाना 
{
  "scope": {
    object (TargetingRuleScope)
  }
}
फ़ील्ड
scope

object (TargetingRuleScope)

ज़रूरी है. इस नियम के हिसाब से, सदस्यताओं का दायरा. सिर्फ़ "यह सदस्यता" और "ऐप्लिकेशन की कोई भी सदस्यता" इस्तेमाल करने की अनुमति है.

TargetingRuleScope

इससे उन सदस्यताओं का दायरा तय होता है जिन्हें टारगेटिंग के नियम से मैच किया जा सकता है. इससे उपयोगकर्ताओं को पिछले या मौजूदा एनटाइटलमेंट के आधार पर ऑफ़र टारगेट किए जा सकते हैं.

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

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
फ़ील्ड

यूनियन फ़ील्ड scope.

scope इनमें से सिर्फ़ एक हो सकती है:
thisSubscription

object (TargetingRuleScopeThisSubscription)

टारगेटिंग के मौजूदा नियम में वह सदस्यता है जिसमें इस ऑफ़र के बारे में बताया गया है.
anySubscriptionInApp

object (TargetingRuleScopeAnySubscriptionInApp)

मौजूदा टारगेटिंग नियम का दायरा, पैरंट ऐप्लिकेशन में मौजूद कोई भी सदस्यता है.
specificSubscriptionInApp

string

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

TargetingRuleScopeThisSubscription

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

इससे उन सदस्यताओं के टारगेट करने के नियम के बारे में पता चलता है जिनमें इस ऑफ़र के बारे में बताया गया है.

TargetingRuleScopeAnySubscriptionInApp

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

पैरंट ऐप्लिकेशन में किसी भी सदस्यता के हिसाब से टारगेटिंग के नियम को दिखाता है.

UpgradeTargetingRule

फ़ॉर्म का टारगेटिंग नियम दिखाता है: उपयोगकर्ता के पास फ़िलहाल {scope} [बिलिंग अवधि {billing_period} के साथ] है.

जेएसओएन के काेड में दिखाना 
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
फ़ील्ड
oncePerUser

boolean

इस ऑफ़र को हर उपयोगकर्ता सिर्फ़ एक बार सीमित कर सकता है. अगर नीति को 'सही है' पर सेट किया जाता है, तो हो सकता है कि किसी उपयोगकर्ता को इस ऑफ़र की सदस्यता दोबारा कभी न मिले.
scope

object (TargetingRuleScope)

ज़रूरी है. इस नियम के हिसाब से, सदस्यताओं का दायरा. सिर्फ़ "यह सदस्यता" और "ऐप्लिकेशन में खास सदस्यता" इस्तेमाल करने की अनुमति है.
billingPeriodDuration

string

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

RegionalSubscriptionOfferConfig

किसी एक क्षेत्र में सदस्यता के ऑफ़र का कॉन्फ़िगरेशन.

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

string

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

boolean

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

OtherRegionsSubscriptionOfferConfig

उन सभी नई जगहों के लिए कॉन्फ़िगरेशन, Play को सदस्यता ऑफ़र में बताई गई जगहों पर लॉन्च किया जा सकता है.

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

boolean

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

तरीके

activate

 इससे सदस्यता के ऑफ़र को चालू किया जाता है.

batchGet

 सदस्यता के एक या उससे ज़्यादा ऑफ़र के बारे में जानकारी देता है.

batchUpdate

 सदस्यता के ऑफ़र के बैच को अपडेट करता है.

batchUpdateStates

 सदस्यता के ऑफ़र की स्थितियों के बैच को अपडेट करता है.

create

 नया सदस्यता ऑफ़र बनाता है.

deactivate

 इससे सदस्यता के ऑफ़र को बंद कर दिया जाता है.

delete

 सदस्यता के ऑफ़र को मिटा देता है.

get

 किसी एक ऑफ़र को पढ़ता है

list

 यह किसी सदस्यता के तहत सभी ऑफ़र की सूची बनाता है.

patch

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