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)

वह कुल कीमत जो ऑफ़र के इस चरण के लिए उपयोगकर्ता को चुकानी होती है. कीमत, उन नई जगहों के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए जहां 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
  },
  "anySubscriptionInApp": {
    object
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
फ़ील्ड

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

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

thisSubscription

object

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

anySubscriptionInApp

object

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

specificSubscriptionInApp

string

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

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

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