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)

इस ऑफ़र का फ़ायदा पाने के लिए, उपयोगकर्ताओं को ये ज़रूरी शर्तें पूरी करनी होंगी. इससे उन ज़रूरी शर्तों के बारे में पता चलता है जिनकी समीक्षा करके Google Play यह तय करेगा कि कोई ऑफ़र वापस किया जाना चाहिए या नहीं. डेवलपर, इन ऑफ़र को खुद भी फ़िल्टर कर सकते हैं.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

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

object (OtherRegionsSubscriptionOfferConfig)

आने वाले समय में, Google Play पर उपलब्ध होने वाले नए देशों या इलाकों के लिए कॉन्फ़िगरेशन.
offerTags[]

object (OfferTag)

इस ऑफ़र के लिए तय किए गए ज़्यादा से ज़्यादा 20 कस्टम टैग की सूची. इसे Play Billing Library के ज़रिए ऐप्लिकेशन को भेजा जाता है.

राज्य

सदस्यता के ऑफ़र की मौजूदा स्थिति.

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)

उन नए देशों/इलाकों के लिए कीमत की जानकारी जहां Google Play को लॉन्च किया जा सकता है.

RegionalSubscriptionOfferPhaseConfig

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

JSON के काेड में दिखाना 
{
  "regionCode": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
regionCode

string

ज़रूरी है. इम्यूटेबल. वह इलाका जहां यह कॉन्फ़िगरेशन लागू होता है.
इस फ़ेज़ के लिए, कीमत में बदलाव. ज़रूरी है. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
price

object (Money)

ऑफ़र के इस चरण के लिए, उपयोगकर्ता को चुकाई जाने वाली कुल कीमत. कीमत, इस देश/इलाके के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए.
relativeDiscount

number

बुनियादी प्लान की कीमत में से छूट का प्रतिशत घटाया जाता है. यह छूट, चरण की अवधि के हिसाब से तय की जाती है. इसे 0 से ज़्यादा और 1 से कम के फ़्रैक्शन के तौर पर दिखाया जाता है. उदाहरण के लिए, 0.8 की वैल्यू का मतलब है कि 80% की छूट मिलेगी. इसका मतलब है कि अगर बुनियादी प्लान की कीमत 100 डॉलर है, तो ऑफ़र की कीमत 20 डॉलर होगी. इसके बाद, कीमत को बिलिंग की सबसे नज़दीकी यूनिट के हिसाब से राउंड कर दिया जाएगा. जैसे, डॉलर के लिए सेंट. अगर छूट वाली कीमत, इस देश या इलाके में तय की गई कम से कम कीमत से कम है, तो रिलेटिव छूट को अमान्य माना जाता है.
absoluteDiscount

object (Money)

बुनियादी प्लान की कीमत में से घटाई गई कुल रकम, जिसे फ़ेज़ की अवधि के हिसाब से तय किया जाता है. उदाहरण के लिए, अगर इस देश/इलाके के लिए बुनियादी प्लान की कीमत एक साल के लिए 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट देने पर, कीमत दो डॉलर होगी. यह ज़रूरी है कि तय की गई कीमत, इस देश/इलाके के लिए तय की गई कम से कम कीमत से कम न हो.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

यह बताने के लिए सेट करें कि यह ऑफ़र बिना किसी शुल्क के उपलब्ध है.
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

RegionalSubscriptionOfferPhaseFreePriceOverride

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

इससे सदस्यता के ऑफ़र के किसी एक चरण के लिए, बिना किसी शुल्क के कीमत बदलने के कॉन्फ़िगरेशन की जानकारी मिलती है

OtherRegionsSubscriptionOfferPhaseConfig

किसी एक ऑफ़र फ़ेज़ के लिए, उन नई जगहों के लिए कॉन्फ़िगरेशन जहां Google Play को लॉन्च किया जा सकता है.

JSON के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
इस फ़ेज़ के लिए, कीमत में बदलाव. ज़रूरी है. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

ऑफ़र के इस चरण के लिए, उपयोगकर्ता को चुकाई जाने वाली कुल कीमत. कीमत, उन नए देशों/इलाकों के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए जहां Google Play को लॉन्च किया जा सकता है.
relativeDiscount

number

बुनियादी प्लान की कीमत में से छूट का प्रतिशत घटाया जाता है. यह छूट, चरण की अवधि के हिसाब से तय की जाती है. इसे 0 से ज़्यादा और 1 से कम के फ़्रैक्शन के तौर पर दिखाया जाता है. उदाहरण के लिए, 0.8 की वैल्यू का मतलब है कि 80% की छूट मिलेगी. इसका मतलब है कि अगर बुनियादी प्लान की कीमत 100 डॉलर है, तो ऑफ़र की कीमत 20 डॉलर होगी. इसके बाद, कीमत को बिलिंग की सबसे नज़दीकी यूनिट के हिसाब से राउंड कर दिया जाएगा. जैसे, डॉलर के लिए सेंट. अगर छूट वाली कीमत, उन नए देशों/इलाकों में तय की गई कम से कम कीमत से कम है जहां Google Play अपनी सेवा लॉन्च कर सकता है, तो रिलेटिव डिस्काउंट को अमान्य माना जाता है.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

बुनियादी प्लान की कीमत में से घटाई गई कुल रकम, जिसे फ़ेज़ की अवधि के हिसाब से तय किया जाता है. उदाहरण के लिए, अगर इस देश/इलाके के लिए बुनियादी प्लान की कीमत एक साल के लिए 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट देने पर, कीमत दो डॉलर होगी. यह हो सकता है कि बदली गई कीमत, उन नए देशों/इलाकों के लिए तय की गई कम से कम कीमत से कम न हो जहां Google Play को लॉन्च किया जा सकता है.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

यह बताने के लिए सेट करें कि यह ऑफ़र बिना किसी शुल्क के उपलब्ध है.
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

OtherRegionsSubscriptionOfferPhasePrices

उन नए देशों/इलाकों के लिए कीमत की जानकारी जहां Google Play को लॉन्च किया जा सकता है.

JSON के काेड में दिखाना 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}
फ़ील्ड
usdPrice

object (Money)

ज़रूरी है. डॉलर में वह कीमत जो Play पर लॉन्च होने वाली नई जगहों के लिए इस्तेमाल की जाएगी.
eurPrice

object (Money)

ज़रूरी है. यूरो में वह कीमत जो Play पर उपलब्ध होने वाले नए देशों/इलाकों में लागू होगी.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

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

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

SubscriptionOfferTargeting

यह उस नियम के बारे में बताता है जिसे पूरा करने पर ही किसी उपयोगकर्ता को यह ऑफ़र मिलेगा.

JSON के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
अगर आपको ऑफ़र की ज़रूरी शर्तें तय करने का विकल्प डेवलपर को देना है, तो इस फ़ील्ड को खाली छोड़ें. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
acquisitionRule

object (AcquisitionTargetingRule)

नए उपयोगकर्ता हासिल करने के लिए, ऑफ़र को टारगेट करने का नियम.
upgradeRule

object (UpgradeTargetingRule)

उपयोगकर्ताओं के मौजूदा प्लान को अपग्रेड करने के लिए, ऑफ़र टारगेटिंग का नियम.
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

AcquisitionTargetingRule

यह टारगेटिंग के इस नियम को दिखाता है: उपयोगकर्ता ने पहले कभी {scope} नहीं लिया.

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

object (TargetingRuleScope)

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

TargetingRuleScope

इससे सदस्यताओं के दायरे के बारे में पता चलता है. टारगेटिंग का कोई नियम, इस दायरे से मैच करके उपयोगकर्ताओं को उनकी पिछली या मौजूदा सदस्यता के आधार पर ऑफ़र टारगेट कर सकता है.

JSON के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of mutually exclusive fields.
}
फ़ील्ड
यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
thisSubscription

object (TargetingRuleScopeThisSubscription)

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

object (TargetingRuleScopeAnySubscriptionInApp)

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

string

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

TargetingRuleScopeThisSubscription

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

यह उन सदस्यताओं के हिसाब से टारगेटिंग के नियम के दायरे को दिखाता है जिनमें यह ऑफ़र तय किया गया है.

TargetingRuleScopeAnySubscriptionInApp

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

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

UpgradeTargetingRule

यह टारगेट करने के नियम को इस तरह दिखाता है: उपयोगकर्ता के पास फ़िलहाल {scope} है [बिलिंग अवधि {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

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

boolean

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

OtherRegionsSubscriptionOfferConfig

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

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

boolean

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

तरीके

activate

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

batchGet

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

batchUpdate

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

batchUpdateStates

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

create

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

deactivate

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

delete

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

get

 एक ऑफ़र की जानकारी दिखाता है

list

 किसी सदस्यता के तहत उपलब्ध सभी ऑफ़र की सूची दिखाता है.

patch

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

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

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

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