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} है [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

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

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

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

गड़बड़ी का कोड कारण रिज़ॉल्यूशन
5xx Google Play सर्वर में सामान्य गड़बड़ी. अनुरोध को फिर से भेजें.

अगर समस्या बनी रहती है, तो अपने Google Play खाता मैनेजर से संपर्क करें या सहायता का अनुरोध सबमिट करें. अगर आपको किसी समस्या के बारे में पहले से पता है, तो Play का स्टेटस डैशबोर्ड देखें.
409 एक साथ कई अपडेट करने पर गड़बड़ी हुई.

किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे पहले से ही अपडेट किया जा रहा है. उदाहरण के लिए, Play Billing Library के acknowledgePurchase() तरीके को कॉल करके और Play Developer API के purchases.products.acknowledge को एक साथ कॉल करके, खरीदारी की पुष्टि की जा रही है.

 अनुरोध को फिर से भेजें.