- संसाधन: SubscriptionOffer
- राज्य
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- 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 |
साफ़ तौर पर बताएं कि यह ऑफ़र मुफ़्त है. |
OtherRegionsSubscriptionOfferPhaseConfig
किसी भी नई जगह के लिए कॉन्फ़िगरेशन, Play को ऑफ़र के एक चरण में लॉन्च किया जा सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड price_override . इस चरण के लिए कीमत में बदलाव. ज़रूरी है. price_override इनमें से सिर्फ़ एक हो सकता है: |
|
otherRegionsPrices |
वह कुल कीमत जो ऑफ़र के इस चरण के लिए उपयोगकर्ता को चुकानी होती है. कीमत, उन नई जगहों के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए जहां Play इसे लॉन्च कर सकता है. |
relativeDiscount |
ऑफ़र के इस चरण के लिए, उपयोगकर्ता के दिए गए फ़ेज़ की अवधि के हिसाब से, बुनियादी प्लान की कीमत का अनुपात. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए 50% की छूट, 1.50 डॉलर के बराबर होगी. छूट को ऐसे भिन्न के रूप में दर्ज किया जाना चाहिए जो 0 से पूरी तरह से ज़्यादा हो और पूरी तरह से 1 से कम हो. नतीजे के तौर पर मिली कीमत, बिल करने लायक सबसे करीबी इकाई में बदल दी जाएगी (जैसे, डॉलर के लिए सेंट). अगर छूट वाली कीमत, Google Play पर लॉन्च की जा सकने वाली नई जगहों पर दी गई कम से कम कीमत से कम होती है, तो मिलती-जुलती छूट को अमान्य माना जाता है. |
absoluteDiscounts |
ऑफ़र के इस चरण के लिए, उपयोगकर्ता के दिए गए फ़ेज़ की अवधि के हिसाब से, बुनियादी प्लान की कीमत में से घटाकर मिली कुल रकम. उदाहरण के लिए, अगर इस क्षेत्र के लिए एक साल की अवधि के लिए बुनियादी प्लान की कीमत 12 डॉलर है, तो तीन महीने की अवधि के लिए एक डॉलर की कुल छूट, दो डॉलर के बराबर होगी. यह कीमत, Play को नई जगहों पर लॉन्च करने के लिए तय की गई कम से कम कीमत से कम नहीं होनी चाहिए. |
free |
साफ़ तौर पर बताएं कि यह ऑफ़र मुफ़्त है. |
OtherRegionsSubscriptionOfferPhasePrices
उन नए जगहों की कीमत की जानकारी जिन्हें Play लॉन्च कर सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ "usdPrice": { object ( |
फ़ील्ड | |
---|---|
usdPrice |
ज़रूरी है. किसी भी नई जगह में Play को लॉन्च करने के लिए, डॉलर में कीमत होनी चाहिए. |
eurPrice |
ज़रूरी है. जिन नई जगहों पर Play लॉन्च हो सकता है वहां इस्तेमाल करने के लिए यूरो में कीमत. |
SubscriptionOfferTargeting
वह नियम तय करता है जिसे उपयोगकर्ता को यह ऑफ़र पाने के लिए पूरा करना होगा.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड rule . अगर आपको डेवलपर की ओर से तय किए गए ऑफ़र की ज़रूरी शर्तों को पूरा करना है, तो इस फ़ील्ड को खाली छोड़ें. rule इनमें से सिर्फ़ एक हो सकता है: |
|
acquisitionRule |
नए उपयोगकर्ता हासिल करने के लिए, ऑफ़र टारगेटिंग का नियम. |
upgradeRule |
उपयोगकर्ताओं के मौजूदा प्लान अपग्रेड करने के लिए, टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) का नियम जोड़ें. |
AcquisitionTargetingRule
फ़ॉर्म के टारगेटिंग नियम को दिखाता है: उपयोगकर्ता के पास पहले कभी {scope} नहीं था.
जेएसओएन के काेड में दिखाना |
---|
{
"scope": {
object ( |
फ़ील्ड | |
---|---|
scope |
ज़रूरी है. उन सदस्यताओं के दायरे जिन्हें इस नियम के तहत तय किया जाता है. सिर्फ़ "यह सदस्यता" और "ऐप्लिकेशन की कोई भी सदस्यता" इस्तेमाल करने की अनुमति है. |
TargetingRuleScope
इससे उन सदस्यताओं के दायरे के बारे में पता चलता है जिन्हें टारगेटिंग के नियम से मैच किया जा सकता है. इससे, उपयोगकर्ताओं को पिछली या मौजूदा सदस्यता के आधार पर ऑफ़र दिखाए जा सकते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
thisSubscription |
टारगेटिंग के मौजूदा नियम का दायरा वह सदस्यता है जिसमें इस ऑफ़र के बारे में बताया गया है. |
anySubscriptionInApp |
मौजूदा टारगेटिंग नियम का दायरा, पैरंट ऐप्लिकेशन की कोई भी सदस्यता है. |
specificSubscriptionInApp |
टारगेटिंग के मौजूदा नियम का दायरा, खास सदस्यता आईडी वाली सदस्यता है. सदस्यता, एक ही पैरंट ऐप्लिकेशन में होनी चाहिए. |
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 की नई जगहों पर, सदस्यता का यह ऑफ़र आने वाले समय में लॉन्च किया जा सकता है या नहीं. अगर कोई वैल्यू तय नहीं की गई है, तो यह डिफ़ॉल्ट रूप से 'गलत है' पर सेट होगा. |
तरीके |
|
---|---|
|
इससे सदस्यता ऑफ़र चालू होता है. |
|
सदस्यता के एक या उससे ज़्यादा ऑफ़र के बारे में पढ़ता है. |
|
सदस्यता के ऑफ़र के बैच को अपडेट करता है. |
|
सदस्यता के ऑफ़र की स्थितियों के बैच को अपडेट करता है. |
|
सदस्यता का नया ऑफ़र बनाता है. |
|
यह सदस्यता ऑफ़र को बंद कर देता है. |
|
सदस्यता का ऑफ़र मिटा दिया जाता है. |
|
किसी एक ऑफ़र को पढ़ता है |
|
यह बटन, किसी सदस्यता के तहत आने वाले सभी ऑफ़र की सूची दिखाता है. |
|
सदस्यता के मौजूदा ऑफ़र को अपडेट करता है. |