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

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

यह टारगेटिंग के नियम को दिखाता है. इसका फ़ॉर्मैट यह होता है: User currently has {scope} [with billing period {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

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

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

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

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