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

ज़रूरी है. इस फ़ेज़ के एक बार दोहराए जाने की अवधि. आईएसओ 8601 फ़ॉर्मैट में तय किया गया है.
regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

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

object (OtherRegionsSubscriptionOfferPhaseConfig)

Play Store के लॉन्च होने की नई जगहों के लिए, कीमत की जानकारी.

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 Store के लॉन्च होने की नई जगहों के लिए, कीमत की जानकारी.

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} है [with billing period {billingPeriod}].

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

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

गड़बड़ी के कोड

इस संसाधन के ऑपरेशन, यहां दिए गए एचटीटीपी गड़बड़ी कोड दिखाते हैं:

गड़बड़ी का कोड कारण ब्यौरा रिज़ॉल्यूशन