REST Resource: monetization.subscriptions.basePlans.offers

संसाधन: SubscriptionOffer

सिर्फ़ एक और कुछ समय के लिए उपलब्ध ऑफ़र

JSON के काेड में दिखाना 
{
  "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

सदस्यता के ऑफ़र का सिर्फ़ एक चरण.

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

integer

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

string

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

object (RegionalSubscriptionOfferPhaseConfig)

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

object (OtherRegionsSubscriptionOfferPhaseConfig)

ऐसे किसी भी नए देश या इलाके की कीमत की जानकारी जहां Play लॉन्च हो सकता है.

RegionalSubscriptionOfferPhaseConfig

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

JSON के काेड में दिखाना 
{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // 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 डॉलर है, तो तीन महीने के लिए 1 डॉलर की कुल छूट, 2 डॉलर के बराबर होगी. नतीजे के तौर पर दिखाई जाने वाली कीमत, इस क्षेत्र के लिए तय की गई कम से कम कीमत से कम नहीं हो सकती.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

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

RegionalSubscriptionOfferPhaseFreePriceOverride

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

यह विकल्प, सदस्यता के ऑफ़र के एक चरण के लिए, बिना किसी शुल्क के चुकाई जाने वाली कीमत का कॉन्फ़िगरेशन दिखाता है

OtherRegionsSubscriptionOfferPhaseConfig

किसी भी नई जगह के लिए कॉन्फ़िगरेशन को, Play किसी एक ऑफ़र चरण के लिए लॉन्च कर सकता है.

JSON के काेड में दिखाना 
{

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

object (OtherRegionsSubscriptionOfferPhasePrices)

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

number

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

object (OtherRegionsSubscriptionOfferPhasePrices)

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

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

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

OtherRegionsSubscriptionOfferPhasePrices

ऐसे किसी भी नए देश या इलाके की कीमत की जानकारी जहां Play लॉन्च हो सकता है.

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

object (Money)

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

object (Money)

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

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

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

यह ऐसे किसी भी नए देश/इलाके के लिए, कीमत में बदलाव करने का कॉन्फ़िगरेशन दिखाता है जहां Google Play को ऑफ़र के किसी एक फ़ेज़ के लिए लॉन्च कर सकता है.

SubscriptionOfferTargeting

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

JSON के काेड में दिखाना 
{

  // 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} नहीं थी.

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

object (TargetingRuleScope)

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

TargetingRuleScope

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

JSON के काेड में दिखाना 
{

  // 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

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

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

boolean

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

object (TargetingRuleScope)

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

string

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

RegionalSubscriptionOfferConfig

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

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

string

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

boolean

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

OtherRegionsSubscriptionOfferConfig

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

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

boolean

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

तरीके

activate

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

batchGet

 एक या उससे ज़्यादा सदस्यता के ऑफ़र पढ़ता है.

batchUpdate

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

batchUpdateStates

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

create

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

deactivate

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

delete

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

get

 एक ऑफ़र पढ़ता है

list

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

patch

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