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

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

इसमें, उन सभी नई जगहों के लिए मुफ़्त में कीमत बदलने की सुविधा का कॉन्फ़िगरेशन दिखता है जहां 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

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

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

boolean

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

object (TargetingRuleScope)

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

string

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

RegionalSubscriptionOfferConfig

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

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

string

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

boolean

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

OtherRegionsSubscriptionOfferConfig

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

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

boolean

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

तरीके

activate

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

batchGet

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

batchUpdate

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

batchUpdateStates

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

create

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

deactivate

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

delete

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

get

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

list

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

patch

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