- संसाधन: SubscriptionOffer
- राज्य
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- RegionalSubscriptionOfferPhaseFreePriceOverride
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- OtherRegionsSubscriptionOfferPhaseFreePriceOverride
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- तरीके
संसाधन: SubscriptionOffer
ऐसा ऑफ़र जो कुछ समय के लिए है
जेएसओएन के काेड में दिखाना |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
फ़ील्ड | |
---|---|
packageName |
ज़रूरी है. इम्यूटेबल. उस ऐप्लिकेशन के पैकेज का नाम जिसकी पैरंट सदस्यता है. |
productId |
ज़रूरी है. इम्यूटेबल. उस पैरंट सदस्यता का आईडी जिसका यह ऑफ़र है. |
basePlanId |
ज़रूरी है. इम्यूटेबल. उस बुनियादी प्लान का आईडी जिसके लिए यह ऑफ़र, एक्सटेंशन के तौर पर इस्तेमाल किया जा रहा है. |
offerId |
ज़रूरी है. इम्यूटेबल. सदस्यता के इस ऑफ़र का यूनीक आईडी. यह बुनियादी प्लान में अलग होना चाहिए. |
state |
सिर्फ़ आउटपुट के लिए. इस ऑफ़र की मौजूदा स्थिति. 'चालू करें' और 'बंद करें' कार्रवाइयों का इस्तेमाल करके, इसे बदला जा सकता है. ध्यान दें: बुनियादी प्लान की स्थिति इस राज्य की जगह लागू हो जाएगी. इसलिए, हो सकता है कि बुनियादी प्लान चालू न होने पर, चालू ऑफ़र उपलब्ध न हो. |
phases[] |
ज़रूरी है. सदस्यता के इस ऑफ़र के चरण. इसमें कम से कम एक एंट्री होनी चाहिए और ज़्यादा से ज़्यादा पांच हो सकते हैं. उपयोगकर्ताओं को ये सभी चरण, हमेशा तय किए गए क्रम में मिलेंगे. शुरुआती चरण बनाने के बाद, न तो फ़ेज़ जोड़े या हटाए जा सकते हैं और न ही उनका क्रम बदला जा सकता है. |
targeting |
इस ऑफ़र का फ़ायदा पाने के लिए, उपयोगकर्ताओं को ये शर्तें पूरी करनी होंगी. उन ज़रूरी शर्तों के बारे में बताता है जिनका आकलन करने के बाद, Play यह तय करेगा कि किसी ऑफ़र को वापस करना चाहिए या नहीं. डेवलपर इन ऑफ़र को खुद फ़िल्टर कर सकते हैं. |
regionalConfigs[] |
ज़रूरी है. इस ऑफ़र का देश/इलाके के हिसाब से कॉन्फ़िगरेशन. इसमें कम से कम एक एंट्री होनी चाहिए. |
otherRegionsConfig |
आने वाले समय में, Play की किसी भी नई जगह का कॉन्फ़िगरेशन लॉन्च किया जा सकता है. |
offerTags[] |
इस ऑफ़र के लिए तय किए गए ज़्यादा से ज़्यादा 20 कस्टम टैग की सूची जिन्हें ऐप्लिकेशन में बिलिंग लाइब्रेरी के ज़रिए दिखाया जाता है. |
स्थिति
सदस्यता के ऑफ़र की मौजूदा स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
डिफ़ॉल्ट वैल्यू, इसका इस्तेमाल कभी नहीं किया जाना चाहिए. |
DRAFT |
सदस्यता का यह ऑफ़र, लोगों के लिए न तो उपलब्ध है और न ही उपलब्ध है. |
ACTIVE |
सदस्यता का यह ऑफ़र, नए और मौजूदा उपयोगकर्ताओं के लिए उपलब्ध है. |
INACTIVE |
सदस्यता का ऑफ़र, नए उपयोगकर्ताओं के लिए उपलब्ध नहीं है. मौजूदा उपयोगकर्ताओं के पास ऐक्सेस बना रहता है. |
SubscriptionOfferPhase
सदस्यता के ऑफ़र का एक फ़ेज़.
जेएसओएन के काेड में दिखाना |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
फ़ील्ड | |
---|---|
recurrenceCount |
ज़रूरी है. यह चरण दोहराने की संख्या. अगर ऑफ़र के इस चरण के लिए कोई शुल्क नहीं लिया जाता, तो हर बार के लिए उपयोगकर्ता से, ऑफ़र के इस चरण का शुल्क लिया जाएगा. |
duration |
ज़रूरी है. इस चरण को एक बार दोहराने का समय. ISO 8601 फ़ॉर्मैट में बताया गया. |
regionalConfigs[] |
ज़रूरी है. इस ऑफ़र के चरण का कॉन्फ़िगरेशन, देश/इलाके के हिसाब से तय होता है. इस सूची में, हर उस इलाके के लिए एक एंट्री होनी चाहिए जिसके लिए, सदस्यता के ऑफ़र का देश/इलाके के हिसाब से कॉन्फ़िगरेशन तय है. |
otherRegionsConfig |
उन सभी नए जगहों की कीमत की जानकारी जहां Play लॉन्च हो सकता है. |
RegionalSubscriptionOfferPhaseConfig
किसी एक क्षेत्र में, सदस्यता के ऑफ़र के एक चरण के लिए कॉन्फ़िगरेशन.
जेएसओएन के काेड में दिखाना |
---|
{ "regionCode": string, // Union field |
फ़ील्ड | |
---|---|
regionCode |
ज़रूरी है. इम्यूटेबल. वह क्षेत्र जहां यह कॉन्फ़िगरेशन लागू होता है. |
यूनियन फ़ील्ड price_override . इस चरण के लिए कीमत में बदलाव. ज़रूरी है. price_override इनमें से सिर्फ़ एक हो सकती है: |
|
price |
वह कुल कीमत जो ऑफ़र के इस चरण के लिए, उपयोगकर्ता को चुकानी होती है. कीमत, इस क्षेत्र के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए. |
relativeDiscount |
ऑफ़र के इस चरण के लिए, उपयोगकर्ता के तय किए गए समय के दौरान, बुनियादी प्लान की कीमत का अनुपात. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए 50% की छूट, 1.50 डॉलर के बराबर होगी. छूट को ऐसे अंश के रूप में दिखाया जाना चाहिए जो 0 से बड़ा हो और 1 से कम हो. इससे मिलने वाली कीमत, बिल करने लायक नज़दीकी यूनिट में बदल दी जाएगी (जैसे कि डॉलर के लिए सेंट). अगर छूट वाली कीमत, इस क्षेत्र में स्वीकार की गई कम से कम कीमत से कम है, तो मिलती-जुलती छूट अमान्य माना जाएगा. |
absoluteDiscount |
ऑफ़र के इस चरण के लिए, उपयोगकर्ता के दिए जाने वाले चरण के हिसाब से, बुनियादी प्लान की कीमत में से घटाकर मिली कुल रकम. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल की अवधि के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट, दो डॉलर के बराबर होगी. यह कीमत, इस क्षेत्र के लिए तय की गई कम से कम कीमत से कम नहीं हो सकती. |
free |
यह बताने के लिए सेट करें कि यह ऑफ़र मुफ़्त में मिल सकता है. |
RegionalSubscriptionOfferPhaseFreePriceOverride
इस टाइप के लिए कोई फ़ील्ड नहीं है.
यह सदस्यता के ऑफ़र के एक चरण के लिए, बिना शुल्क वाली कीमत के बदलाव का कॉन्फ़िगरेशन दिखाता है
OtherRegionsSubscriptionOfferPhaseConfig
उन नई जगहों के लिए कॉन्फ़िगरेशन जो Play को ऑफ़र के एक चरण में लॉन्च किया जा सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड price_override . इस चरण के लिए कीमत में बदलाव. ज़रूरी है. price_override इनमें से सिर्फ़ एक हो सकती है: |
|
otherRegionsPrices |
वह कुल कीमत जो ऑफ़र के इस चरण के लिए, उपयोगकर्ता को चुकानी होती है. कीमत, उन नई जगहों के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए जहां Google Play को लॉन्च कर सकते हैं. |
relativeDiscount |
ऑफ़र के इस चरण के लिए, उपयोगकर्ता के तय किए गए समय के दौरान, बुनियादी प्लान की कीमत का अनुपात. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए 50% की छूट, 1.50 डॉलर के बराबर होगी. छूट को ऐसे अंश के रूप में दिखाया जाना चाहिए जो 0 से बड़ा हो और 1 से कम हो. इससे मिलने वाली कीमत, बिल करने लायक नज़दीकी यूनिट में बदल दी जाएगी (जैसे कि डॉलर के लिए सेंट). अगर छूट वाली कीमत, Google Play की नई जगहों पर लॉन्च की जा सकने वाली कम से कम कीमत से भी कम होती है, तो मिलती-जुलती छूट को अमान्य माना जाता है. |
absoluteDiscounts |
ऑफ़र के इस चरण के लिए, उपयोगकर्ता के दिए जाने वाले चरण के हिसाब से, बुनियादी प्लान की कीमत में से घटाकर मिली कुल रकम. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल की अवधि के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट, दो डॉलर के बराबर होगी. यह कीमत, हो सकता है कि उन नई जगहों के लिए तय की गई कम से कम कीमत से कम न हो जहां Play को लॉन्च किया जा सकता है. |
free |
यह बताने के लिए सेट करें कि यह ऑफ़र मुफ़्त में मिल सकता है. |
OtherRegionsSubscriptionOfferPhasePrices
उन सभी नए जगहों की कीमत की जानकारी जहां Play लॉन्च हो सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ "usdPrice": { object ( |
फ़ील्ड | |
---|---|
usdPrice |
ज़रूरी है. किसी भी नई जगह पर Play को लॉन्च करने के लिए डॉलर में कीमत. |
eurPrice |
ज़रूरी है. किसी भी नई जगह पर Play को लॉन्च करने के लिए, यूरो में दी गई कीमत. |
OtherRegionsSubscriptionOfferPhaseFreePriceOverride
इस टाइप के लिए कोई फ़ील्ड नहीं है.
यह उन सभी नई जगहों के लिए कीमत में बदलाव के लिए मुफ़्त कॉन्फ़िगरेशन दिखाता है जहां Play, एक ऑफ़र के चरण में लॉन्च कर सकता है.
SubscriptionOfferTargeting
वह नियम तय करता है जिसे उपयोगकर्ता को यह ऑफ़र पाने के लिए पूरा करना होगा.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड rule . डेवलपर की ओर से तय किए गए ऑफ़र की ज़रूरी शर्तों के बारे में जानने के लिए, इस फ़ील्ड को खाली छोड़ दें. rule इनमें से सिर्फ़ एक हो सकती है: |
|
acquisitionRule |
नए उपयोगकर्ता हासिल करने के लिए ऑफ़र टारगेटिंग का नियम. |
upgradeRule |
उपयोगकर्ताओं के मौजूदा प्लान अपग्रेड करने के लिए, ऑफ़र टारगेटिंग का नियम. |
AcquisitionTargetingRule
फ़ॉर्म का टारगेटिंग नियम दिखाता है: उपयोगकर्ता के पास पहले कभी {scope} नहीं था.
जेएसओएन के काेड में दिखाना |
---|
{
"scope": {
object ( |
फ़ील्ड | |
---|---|
scope |
ज़रूरी है. इस नियम के हिसाब से, सदस्यताओं का दायरा. सिर्फ़ "यह सदस्यता" और "ऐप्लिकेशन की कोई भी सदस्यता" इस्तेमाल करने की अनुमति है. |
TargetingRuleScope
इससे उन सदस्यताओं का दायरा तय होता है जिन्हें टारगेटिंग के नियम से मैच किया जा सकता है. इससे उपयोगकर्ताओं को पिछले या मौजूदा एनटाइटलमेंट के आधार पर ऑफ़र टारगेट किए जा सकते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
thisSubscription |
टारगेटिंग के मौजूदा नियम में वह सदस्यता है जिसमें इस ऑफ़र के बारे में बताया गया है. |
anySubscriptionInApp |
मौजूदा टारगेटिंग नियम का दायरा, पैरंट ऐप्लिकेशन में मौजूद कोई भी सदस्यता है. |
specificSubscriptionInApp |
मौजूदा टारगेटिंग नियम का दायरा, खास सदस्यता आईडी वाली सदस्यता है. एक ही पैरंट ऐप्लिकेशन में सदस्यता होनी चाहिए. |
TargetingRuleScopeThisSubscription
इस टाइप के लिए कोई फ़ील्ड नहीं है.
इससे उन सदस्यताओं के टारगेट करने के नियम के बारे में पता चलता है जिनमें इस ऑफ़र के बारे में बताया गया है.
TargetingRuleScopeAnySubscriptionInApp
इस टाइप के लिए कोई फ़ील्ड नहीं है.
पैरंट ऐप्लिकेशन में किसी भी सदस्यता के हिसाब से टारगेटिंग के नियम को दिखाता है.
UpgradeTargetingRule
फ़ॉर्म का टारगेटिंग नियम दिखाता है: उपयोगकर्ता के पास फ़िलहाल {scope} [बिलिंग अवधि {billing_period} के साथ] है.
जेएसओएन के काेड में दिखाना |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
फ़ील्ड | |
---|---|
oncePerUser |
इस ऑफ़र को हर उपयोगकर्ता सिर्फ़ एक बार सीमित कर सकता है. अगर नीति को 'सही है' पर सेट किया जाता है, तो हो सकता है कि किसी उपयोगकर्ता को इस ऑफ़र की सदस्यता दोबारा कभी न मिले. |
scope |
ज़रूरी है. इस नियम के हिसाब से, सदस्यताओं का दायरा. सिर्फ़ "यह सदस्यता" और "ऐप्लिकेशन में खास सदस्यता" इस्तेमाल करने की अनुमति है. |
billingPeriodDuration |
ISO 8601 फ़ॉर्मैट में तय की गई बिलिंग अवधि के लिए, इस नियम का पालन करने के लिए उपयोगकर्ता के पास मौजूदा समय में सदस्यता होना ज़रूरी है. अगर इसके बारे में नहीं बताया गया है, तो किसी भी बिलिंग अवधि की सदस्यता लेने वाले उपयोगकर्ताओं का मिलान किया जाता है. |
RegionalSubscriptionOfferConfig
किसी एक क्षेत्र में सदस्यता के ऑफ़र का कॉन्फ़िगरेशन.
जेएसओएन के काेड में दिखाना |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
फ़ील्ड | |
---|---|
regionCode |
ज़रूरी है. इम्यूटेबल. वह क्षेत्र कोड जिस पर यह कॉन्फ़िगरेशन लागू होता है, जैसा कि ISO 3166-2 के मुताबिक तय किया गया है, जैसे कि "US". |
newSubscriberAvailability |
क्या किसी खास इलाके में नए सदस्यों के लिए, सदस्यता का ऑफ़र उपलब्ध है. अगर यह वैल्यू 'गलत है' पर सेट है, तो मौजूदा सदस्यों की सदस्यता रद्द नहीं होगी. अगर इसके बारे में नहीं बताया गया है, तो यह डिफ़ॉल्ट रूप से 'गलत' पर सेट होगा. |
OtherRegionsSubscriptionOfferConfig
उन सभी नई जगहों के लिए कॉन्फ़िगरेशन, Play को सदस्यता ऑफ़र में बताई गई जगहों पर लॉन्च किया जा सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
फ़ील्ड | |
---|---|
otherRegionsNewSubscriberAvailability |
Play की किसी नई जगह पर सदस्यता का ऑफ़र, आने वाले समय में लॉन्च किया जा सकता है या नहीं. अगर इसके बारे में नहीं बताया गया है, तो यह डिफ़ॉल्ट रूप से 'गलत' पर सेट होगा. |
तरीके |
|
---|---|
|
इससे सदस्यता के ऑफ़र को चालू किया जाता है. |
|
सदस्यता के एक या उससे ज़्यादा ऑफ़र के बारे में जानकारी देता है. |
|
सदस्यता के ऑफ़र के बैच को अपडेट करता है. |
|
सदस्यता के ऑफ़र की स्थितियों के बैच को अपडेट करता है. |
|
नया सदस्यता ऑफ़र बनाता है. |
|
इससे सदस्यता के ऑफ़र को बंद कर दिया जाता है. |
|
सदस्यता के ऑफ़र को मिटा देता है. |
|
किसी एक ऑफ़र को पढ़ता है |
|
यह किसी सदस्यता के तहत सभी ऑफ़र की सूची बनाता है. |
|
सदस्यता के मौजूदा ऑफ़र को अपडेट करता है. |