इस गाइड में, Google Play Developer API का इस्तेमाल करके, Play पर मौजूद अपने ऐप्लिकेशन के लिए प्रॉडक्ट कैटलॉग बनाने और उसे मैनेज करने का तरीका बताया गया है.
Google Play के बिलिंग सिस्टम का इस्तेमाल करके, अपने ऐप्लिकेशन में प्रॉडक्ट बेचने के लिए, आपको एक कैटलॉग सेट अप करना होगा. इसमें वे सभी प्रॉडक्ट शामिल होने चाहिए जिन्हें आपको उपयोगकर्ताओं के लिए उपलब्ध कराना है. ऐसा Play Console की मदद से किया जा सकता है. इसके अलावा, Google Play Developer API का इस्तेमाल करके, कैटलॉग मैनेजमेंट को ऑटोमेट किया जा सकता है. ऑटोमेशन की मदद से, यह पक्का किया जा सकता है कि आपका कैटलॉग हमेशा अप-टू-डेट रहे. साथ ही, बड़े कैटलॉग को स्केल किया जा सकता है, जहां मैन्युअल तरीके से काम करना मुश्किल होता है. इस गाइड में, आपको Play पर मौजूद अपने ऐप्लिकेशन के लिए प्रॉडक्ट कैटलॉग बनाने और उसे मैनेज करने के लिए, Google Play Developer API को इस्तेमाल करने का तरीका बताया गया है. बैकएंड इंटिग्रेशन के लिए, Google Play Developer API को सेट अप करने के बारे में जानने के लिए, तैयार हो जाएं गाइड देखें.
Catalog Management API
Google Play के बिलिंग सिस्टम की मदद से बेचे जा सकने वाले अलग-अलग तरह के प्रॉडक्ट के बारे में जानने के लिए, ऐप्लिकेशन में खरीदने के लिए उपलब्ध प्रॉडक्ट के टाइप और कैटलॉग से जुड़ी ज़रूरी जानकारी लेख पढ़ें. Google, Play पर कैटलॉग मैनेज करने के लिए एपीआई के दो मुख्य सेट उपलब्ध कराता है. ये सेट, प्रॉडक्ट की दो मुख्य कैटगरी के हिसाब से होते हैं:
- वन-टाइम प्रॉडक्ट
- शुल्क लेकर सेवा देने वाले प्रॉडक्ट
वन-टाइम प्रॉडक्ट
वन-टाइम प्रॉडक्ट (पहले इन्हें ऐप्लिकेशन में खरीदने के लिए उपलब्ध प्रॉडक्ट कहा जाता था), वन-टाइम प्रॉडक्ट के ऑब्जेक्ट मॉडल का इस्तेमाल करते हैं. इसकी मदद से, वन-टाइम प्रॉडक्ट के लिए खरीदारी के कई विकल्प और ऑफ़र कॉन्फ़िगर किए जा सकते हैं. वन-टाइम प्रॉडक्ट के ऑब्जेक्ट मॉडल की मदद से, प्रॉडक्ट बेचने के तरीके में ज़्यादा सहूलियत मिलती है. साथ ही, प्रॉडक्ट मैनेज करते समय आने वाली समस्याएं कम होती हैं. ऐप्लिकेशन में खरीदने के लिए उपलब्ध आपके मौजूदा प्रॉडक्ट, वन-टाइम प्रॉडक्ट के ऑब्जेक्ट मॉडल पर माइग्रेट कर दिए जाएंगे. ज़्यादा जानकारी के लिए, ऐप्लिकेशन में खरीदने के लिए उपलब्ध प्रॉडक्ट माइग्रेट करना लेख पढ़ें.
monetization.onetimeproducts और inappproducts एंडपॉइंट की मदद से, अपने बैकएंड से वन-टाइम प्रॉडक्ट मैनेज किए जा सकते हैं. इसमें प्रॉडक्ट बनाना, अपडेट करना, और मिटाना शामिल है. साथ ही, कीमतों और उपलब्धता को मैनेज करना भी शामिल है. वन-टाइम प्रॉडक्ट की खरीदारी को मैनेज करने के आपके तरीके के आधार पर, इस्तेमाल किए जा सकने वाले प्रॉडक्ट (इन्हें जितनी बार चाहें उतनी बार खरीदा जा सकता है) या स्थायी एनटाइटेलमेंट (एक ही उपयोगकर्ता इन्हें दो बार नहीं खरीद सकता) को मॉडल किया जाएगा. आपके पास यह तय करने का विकल्प होता है कि कौनसे वन-टाइम प्रॉडक्ट इस्तेमाल किए जा सकते हैं और कौनसे नहीं.
शुल्क लेकर सेवा देने वाले प्रॉडक्ट
monetization.subscriptions एंडपॉइंट की मदद से, डेवलपर बैकएंड से सदस्यता वाले प्रॉडक्ट मैनेज किए जा सकते हैं. आपके पास सदस्यताएं बनाने, उन्हें अपडेट करने, और मिटाने का विकल्प होता है. इसके अलावा, क्षेत्र के हिसाब से उनकी उपलब्धता और कीमत को कंट्रोल किया जा सकता है. monetization.subscriptions एंडपॉइंट के अलावा, हम monetization.subscriptions.basePlans और monetization.subscriptions.basePlans.offers भी उपलब्ध कराते हैं. इनकी मदद से, सदस्यताओं के बुनियादी प्लान और ऑफ़र मैनेज किए जा सकते हैं.
बैच के तरीके
onetimeproducts,
inappproducts, और monetization.subscriptions
एंडपॉइंट, बैच के कई तरीके उपलब्ध कराते हैं. इनकी मदद से, एक ही ऐप्लिकेशन में एक साथ
100 इकाइयों को वापस लाया जा सकता है या मैनेज किया जा सकता है.
बैच के तरीकों का इस्तेमाल, इंतज़ार के समय को कम करने की सुविधा के साथ करने पर, ज़्यादा थ्रूपुट मिलता है. ये तरीके, बड़े कैटलॉग वाले डेवलपर के लिए खास तौर पर मददगार होते हैं. इनकी मदद से, शुरुआती कैटलॉग बनाया जा सकता है या कैटलॉग को फिर से व्यवस्थित किया जा सकता है.
अपडेट प्रोपेगेशन लेटेंसी बनाम थ्रूपुट
प्रॉडक्ट बनाने या उसमें बदलाव करने का अनुरोध पूरा होने के बाद, हो सकता है कि असली उपयोगकर्ताओं को अपने डिवाइसों पर तुरंत बदलाव न दिखें. ऐसा नेटवर्क या बैकएंड प्रोसेसिंग में देरी की वजह से हो सकता है. डिफ़ॉल्ट रूप से, प्रॉडक्ट में बदलाव करने के सभी अनुरोधों में इंतज़ार का समय कम होता है. इसका मतलब है कि उन्हें बैकएंड सिस्टम के ज़रिए तेज़ी से लागू करने के लिए ऑप्टिमाइज़ किया गया है. आम तौर पर, ये बदलाव असली उपयोगकर्ता के डिवाइसों पर कुछ ही मिनटों में दिखने लगते हैं.
हालांकि, हर घंटे के हिसाब से ऐसे अनुरोधों की संख्या सीमित होती है.
अगर आपको कई प्रॉडक्ट बनाने या अपडेट करने हैं (उदाहरण के लिए, शुरुआत में बड़ा कैटलॉग बनाते समय), तो बैच वाले तरीकों का इस्तेमाल किया जा सकता है. इसके लिए, latencyTolerance फ़ील्ड को PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT पर सेट करें. इससे अपडेट थ्रूपुट में काफ़ी बढ़ोतरी होगी. लेटेंसी-टॉलरेंट अपडेट को असली उपयोगकर्ता के डिवाइसों पर लागू होने में 24 घंटे लग सकते हैं.
कोटा कॉन्फ़िगरेशन
अपने प्रॉडक्ट कैटलॉग को मैनेज करने के लिए, Play Developer API का इस्तेमाल करते समय आपको कोटे की कई सीमाओं के बारे में पता होना चाहिए:
- Google Play Developer API को बकेट नाम की कैटगरी में व्यवस्थित किया गया है. हर बकेट के लिए, एक मिनट में किए जा सकने वाले अनुरोधों की सीमा तय की गई है. ज़्यादा जानकारी के लिए, कोटा देखें.
- प्रॉडक्ट में बदलाव करने वाले एंडपॉइंट के लिए, हर घंटे 7,200 क्वेरी की सीमा भी लागू होती है. यह सीमा, वन-टाइम प्रॉडक्ट और सदस्यताओं, दोनों पर लागू होती है. साथ ही, यह बदलाव करने के सभी अनुरोधों पर लागू होती है. जैसे, प्रॉडक्ट बनाने, अपडेट करने, चालू करने, और मिटाने के अनुरोध. बैच में बदलाव करने के तरीके के कॉल, इस कोटे के लिए एक क्वेरी के तौर पर गिने जाते हैं. इससे कोई फ़र्क़ नहीं पड़ता कि इसमें कितने अनुरोध शामिल हैं या उनकी इंतज़ार का समय कितना है.
- इंतज़ार के समय से जुड़े बदलावों के लिए भी, हर घंटे 7,200 बदलावों की सीमा तय की गई है. बैच के तरीकों के लिए, इस कोटे के तहत बदलाव करने के हर नेस्ट किए गए अनुरोध को अलग से गिना जाता है. इस कोटे का असर सिर्फ़ उन उपयोगकर्ताओं पर पड़ता है जो बैच एपीआई का इस्तेमाल करके, इंतज़ार के समय से जुड़े अपडेट करते हैं. ऐसा इसलिए, क्योंकि अन्य मामलों में कोटा 2, इस कोटे से पहले या इसके साथ ही खत्म हो जाएगा.
अलग-अलग अनुरोधों के लिए कोटा के इस्तेमाल को समझने के लिए, यहां कुछ उदाहरण दिए गए हैं:
- एक आइटम फ़ेच करने के लिए,
getका एक अनुरोध करने पर, कोटा 1 का एक टोकन इस्तेमाल होगा. साथ ही, कोटा 2 और 3 का कोई टोकन इस्तेमाल नहीं होगा, क्योंकि वे सिर्फ़ बदलाव करने वाले एंडपॉइंट से जुड़े होते हैं. - ज़्यादा से ज़्यादा 100 आइटम फ़ेच करने के लिए, बैच
getअनुरोध करने पर भी कोटा 1 का एक टोकन खर्च होगा. हालांकि, कोटा 2 और 3 का कोई टोकन खर्च नहीं होगा. - एक आइटम के लिए किए गए एक
modificationअनुरोध में, कोटा 1 का एक टोकन और कोटा 2 का एक टोकन इस्तेमाल होगा. अगर अनुरोध में इंतज़ार का समय कम होना ज़रूरी है, तो कोटा 3 का एक टोकन भी इस्तेमाल किया जाएगा. कोटा C की सीमा, कोटा 2 के बराबर है. इसलिए, सिर्फ़ एक बदलाव करने के तरीकों का इस्तेमाल करने वाले उपयोगकर्ताओं पर इसका कोई असर नहीं पड़ता. - देरी से जवाब देने वाले 100 आइटम के लिए, बैच
modificationअनुरोध करने पर, कोटा 1 का एक टोकन और कोटा 2 का एक टोकन इस्तेमाल होगा. इस कोटा सेटअप से, आपके कैटलॉग को अपडेट रखने के लिए ज़रूरत के मुताबिक मार्जिन मिलना चाहिए. हालांकि, अगर आपके एल्गोरिदम को इस कोटा की जानकारी नहीं है और वह इस दर से ज़्यादा है, तो आपको हर अतिरिक्त कॉल के लिए गड़बड़ी का मैसेज मिल सकता है. - लेटेंसी के हिसाब से संवेदनशील 100 आइटम के लिए, बैच
modificationके अनुरोध में, कोटे 1 का एक टोकन, कोटे 2 का एक टोकन, और कोटे 3 के 100 टोकन इस्तेमाल होंगे.
Catalog Management API के इस्तेमाल से जुड़े सुझाव
इन दिशा-निर्देशों का पालन करके, एपीआई के साथ अपने इंटरैक्शन को ऑप्टिमाइज़ किया जा सकता है. इससे कैटलॉग को आसानी से और बेहतर तरीके से मैनेज किया जा सकता है.
अपने इस्तेमाल पर नज़र रखना
आपको ज़्यादा डेटा इस्तेमाल करने वाली प्रोसेस के बारे में पता होना चाहिए. उदाहरण के लिए, इंटिग्रेशन की शुरुआत में, आपके कैटलॉग मैनेजमेंट एंडपॉइंट, आपके पूरे शुरुआती कैटलॉग को बनाने के लिए ज़्यादा कोटा इस्तेमाल कर सकते हैं. अगर आप इस्तेमाल की कुल सीमा के करीब हैं, तो इससे खरीदारी की स्थिति वाले एपीआई जैसे अन्य एंडपॉइंट के प्रोडक्शन इस्तेमाल पर असर पड़ सकता है. आपको अपने कोटे के इस्तेमाल पर नज़र रखनी होगी, ताकि यह पक्का किया जा सके कि एपीआई कोटा तय सीमा से ज़्यादा न हो. इस्तेमाल पर नज़र रखने के कई तरीके हैं. उदाहरण के लिए, Google Cloud API के कोटा डैशबोर्ड का इस्तेमाल किया जा सकता है. इसके अलावा, अपनी पसंद के किसी भी इन-हाउस या तीसरे पक्ष के एपीआई मॉनिटरिंग टूल का इस्तेमाल किया जा सकता है.
एपीआई कोटे के इस्तेमाल को ऑप्टिमाइज़ करना
हमारा सुझाव है कि रेट की खपत को ऑप्टिमाइज़ करें, ताकि एपीआई से जुड़ी गड़बड़ियों की संभावना कम से कम हो. इसे असरदार तरीके से लागू करने के लिए, हमारा सुझाव है कि आप:
- कैटलॉग मैनेज करने की सही रणनीति चुनें. एपीआई कोटा के बारे में जानने के बाद, आपको अपने ऐप्लिकेशन के लिए सही रणनीति चुननी होगी. इससे आपको कैटलॉग मैनेजमेंट के लक्ष्यों को बेहतर तरीके से हासिल करने में मदद मिलेगी.
- अपने बदलावों को दिखाने के लिए, सिर्फ़ ज़रूरी कॉल करें.
- एपीआई में बदलाव करने के लिए, ग़ैर-ज़रूरी या बार-बार कॉल न करें. इसके लिए, आपको अपने बैकएंड कैटलॉग में बदलावों का लॉग रखना पड़ सकता है.
- प्रॉडक्ट में बदलाव करने के लिए, हर घंटे 7,200 क्वेरी की जा सकती हैं. ऐसा हो सकता है कि आपको सिंक करने की ऐसी प्रोसेस बनानी हों जिनमें कम समय में प्रॉडक्ट में कई बदलाव करने की ज़रूरत हो. उदाहरण के लिए, शुरुआती कैटलॉग बनाना. अगर आपको लगता है कि ये प्रोसेस हर घंटे की तय सीमा से ज़्यादा हो सकती हैं, तो ज़रूरत के हिसाब से इंतज़ार करें. इससे, इस्तेमाल को सुरक्षित लेवल तक कम किया जा सकता है. ज़्यादा थ्रूपुट पाने के लिए, बैच वाले तरीकों का इस्तेमाल करें. साथ ही, ऐसे अपडेट इस्तेमाल करें जिनमें इंतज़ार का समय ज़्यादा हो.
- कारोबार को आगे बढ़ाने के लिए पहले से तैयारी करें. जैसे-जैसे आपका ऐप्लिकेशन बढ़ता है, आपको एपीआई और अलग-अलग एंडपॉइंट के इस्तेमाल को बढ़ाने की ज़रूरत पड़ सकती है. अगर आपको ज़्यादा से ज़्यादा इस्तेमाल की सीमा के करीब पहुंचने पर अपना कोटा बढ़ाने का तरीका जानना है, तो Google Play Developer API के कोटे से जुड़ा दस्तावेज़ पढ़ें.
- ज़्यादा रिसॉर्स इस्तेमाल करने वाली प्रोसेस को सोच-समझकर शेड्यूल करें. कैटलॉग से जुड़ी ज़्यादा डेटा वाली प्रोसेस को, पीक टाइम के दौरान शेड्यूल करें. उदाहरण के लिए, हफ़्ते के दौरान बिक्री के पीक टाइम पर, पूरे कैटलॉग को सिंक करने से बचें.
कोटा से जुड़ी गड़बड़ी को मैनेज करने का लॉजिक जोड़ना
आपने कैटलॉग मैनेजमेंट लॉजिक को चाहे जितने बेहतर तरीके से बनाया हो, आपको उसे कोटा की सीमाओं के हिसाब से बनाना चाहिए. ऐसा इसलिए, क्योंकि रोज़ का कोटा, आपके इंटिग्रेशन के अलग-अलग मॉड्यूल में इस्तेमाल किए जाने वाले एंडपॉइंट के साथ शेयर किया जाता है. पक्का करें कि आपने गड़बड़ी को मैनेज करने के लिए, कोटा थ्रॉटलिंग की गड़बड़ियों को शामिल किया हो. साथ ही, सही तरीके से इंतज़ार करने की सुविधा लागू की हो. Google Play Developer API को किए गए हर कॉल से एक जवाब जनरेट होगा. कॉल न हो पाने पर, आपको गड़बड़ी का रिस्पॉन्स मिलेगा. इसमें एचटीटीपी रिस्पॉन्स स्टेटस कोड और errors ऑब्जेक्ट शामिल होता है. इससे गड़बड़ी के डोमेन और डीबग मैसेज के बारे में ज़्यादा जानकारी मिलती है. उदाहरण के लिए, अगर आपने रोज़ाना इस्तेमाल की समयसीमा पूरी कर ली है, तो आपको इस तरह की गड़बड़ी दिख सकती है:
{
"code" : 403,
"errors" : [ {
"domain" : "usageLimits",
"message" : "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API
Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxxx",
"reason" : "dailyLimitExceeded",
"extendedHelp" : "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxx"
} ],
}
कैटलॉग मैनेजमेंट लागू करने का तरीका
डेवलपर, Google Play Developer API के प्रॉडक्ट पब्लिश करने वाले एंडपॉइंट का इस्तेमाल करते हैं, ताकि वे अपने बैकएंड और Google Play के बीच कैटलॉग को सिंक कर सकें. यह पक्का करने से कि Google Play कैटलॉग हमेशा आपके बैकएंड के कैटलॉग की नई जानकारी के साथ अप-टू-डेट रहे, उपयोगकर्ताओं को बेहतर अनुभव देने में मदद मिलती है. उदाहरण के लिए:
- आपको उपलब्ध ऑफ़र की पूरी सूची देखने को मिलेगी. साथ ही, ऑफ़र और बुनियादी प्लान के टैग मैनेज करने का विकल्प मिलेगा. इससे आपको यह तय करने में मदद मिलेगी कि आपके ऑफ़र किन लोगों को और कैसे दिखें.
- अलग-अलग प्लैटफ़ॉर्म पर उपयोगकर्ताओं को दिखने वाले अलग-अलग प्राइस पॉइंट और प्रॉडक्ट की जानकारी देखी जा सकती है. साथ ही, यह पक्का किया जा सकता है कि वे एक जैसे हों.
- नई खरीदारी को प्रोसेस करते समय, आपके पास अपने बैकएंड में प्रॉडक्ट की जानकारी मौजूद होगी. इसके लिए, आपको उपयोगकर्ता के अहम फ़्लो के दौरान, Google Play Developer API को अतिरिक्त कॉल करने की ज़रूरत नहीं होगी. इससे, इंतज़ार का समय और गड़बड़ी होने का जोखिम कम हो जाएगा.
Google Play पर अपना प्रॉडक्ट कैटलॉग बनाते समय, आपको कुछ सीमाओं और ज़रूरी बातों का ध्यान रखना चाहिए. इन सीमाओं को समझने और कैटलॉग को व्यवस्थित करने का तरीका जानने के बाद, सिंक करने की रणनीति तय करें.
कैटलॉग सिंक करने की रणनीतियां
Google Play Developer API के पब्लिशिंग एंडपॉइंट की मदद से, बदलाव होने पर अपने कैटलॉग को अपडेट किया जा सकता है. कभी-कभी, आपको समय-समय पर अपडेट करने का तरीका अपनाना पड़ सकता है. इसमें एक ही प्रोसेस में कई बदलाव भेजे जाते हैं. हर तरीके के लिए, डिज़ाइन के अलग-अलग विकल्प चुनने की ज़रूरत होती है. सिंक करने की हर रणनीति, इस्तेमाल के कुछ उदाहरणों के लिए दूसरों की तुलना में बेहतर होगी. साथ ही, हो सकता है कि आपकी कुछ ज़रूरतें ऐसी हों जिनके लिए स्थिति के हिसाब से, दोनों रणनीतियों की ज़रूरत पड़े.
कभी-कभी, किसी नए बदलाव के बारे में पता चलते ही, आपको किसी प्रॉडक्ट को अपडेट करना पड़ सकता है.उदाहरण के लिए, प्रॉडक्ट के ज़रूरी अपडेट को प्रोसेस करना. जैसे, गलत कीमत को जल्द से जल्द ठीक करना. कभी-कभी, समय-समय पर बैकग्राउंड में सिंक करने की सुविधा का इस्तेमाल किया जा सकता है. इससे यह पक्का किया जा सकता है कि आपका बैकएंड और Play कैटलॉग हमेशा एक जैसा रहे. कैटलॉग मैनेज करने की इन अलग-अलग रणनीतियों को लागू करने के कुछ सामान्य उदाहरण यहां दिए गए हैं.
स्थानीय कैटलॉग में बदलाव होने पर अपडेट कब भेजने चाहिए
आदर्श रूप से, आपके बैकएंड के प्रॉडक्ट कैटलॉग में कोई भी बदलाव होते ही अपडेट होने चाहिए, ताकि गड़बड़ियों को कम किया जा सके.
इस तरह के अपडेट तब काम आते हैं, जब:
- आपको यह पक्का करना होगा कि आपके प्रॉडक्ट हमेशा अप-टू-डेट हों.
- आपको हर दिन अपने प्रॉडक्ट में कुछ बदलाव करने होंगे.
- आपको उन प्रॉडक्ट को अपडेट करना होगा जो पहले से ही प्रोडक्शन में हैं और बेचे जा रहे हैं.
इस तरीके को लागू करना आसान है. इससे, कैटलॉग को सिंक किया जा सकता है. साथ ही, इसमें गड़बड़ी की संभावना कम होती है.
समय-समय पर अपडेट करने की सुविधा का इस्तेमाल कब करना चाहिए
समय-समय पर होने वाले अपडेट, आपके बैकएंड पर प्रॉडक्ट के वर्शन के साथ एसिंक्रोनस तरीके से चलते हैं. ये अपडेट तब एक अच्छा विकल्प होते हैं, जब:
- आपको कम समय में अपने प्रॉडक्ट अपडेट करने की ज़रूरत नहीं है.
- आपको एक साथ कई अपडेट करने या सुलह की प्रोसेस के लिए प्लान बनाना होगा.
- आपके पास पहले से ही अपने डिजिटल प्रॉडक्ट मैनेज करने के लिए, कॉन्टेंट या कैटलॉग मैनेजमेंट सिस्टम है. साथ ही, यह सिस्टम आपके कैटलॉग को लगातार अपडेट करता रहता है
बड़े कैटलॉग के लिए, बैच वाले तरीकों का इस्तेमाल करें. साथ ही, ज़्यादा से ज़्यादा थ्रूपुट पाने के लिए, इंतज़ार के समय को कम करने वाले अपडेट का इस्तेमाल करें.
प्रॉडक्ट कैटलॉग बनाना
अगर आपको Google Play पर अपलोड करने के लिए बड़ा कैटलॉग अपलोड करना है, तो शुरुआती लोड को ऑटोमेट किया जा सकता है. इस तरह की भारी प्रोसेस तब सबसे अच्छी तरह काम करती है, जब समय-समय पर लागू होने वाली रणनीति के साथ-साथ, इंतज़ार के समय को कम करने वाले बैच के तरीकों का इस्तेमाल किया जाता है.
वन-टाइम प्रॉडक्ट बनाना
पहली बार वन-टाइम प्रॉडक्ट कैटलॉग बनाने के लिए, हमारा सुझाव है कि आप monetization.onetimeproducts.batchUpdate या inapp_products.insert तरीके का इस्तेमाल करें. इसके लिए, allowMissing फ़ील्ड को true पर और latencyTolerance फ़ील्ड को PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT पर सेट करें. इससे, कोटे की सीमाओं के अंदर कैटलॉग बनाने में लगने वाला समय कम हो जाएगा.
शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट बनाना
सदस्यता के लिए बड़ा कैटलॉग बनाने के लिए, हमारा सुझाव है कि आप monetization.subscriptions.batchUpdate तरीके का इस्तेमाल करें. इसमें allowMissing फ़ील्ड को true पर और latencyTolerance फ़ील्ड को PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT पर सेट करें. इससे, कोटे की सीमाओं के अंदर कैटलॉग बनाने में लगने वाला समय कम हो जाएगा.
सदस्यताओं के छोटे कैटलॉग के लिए, Play Developer API में monetization.subscriptions.create तरीका उपलब्ध है.
इसके अलावा, प्रॉडक्ट अपडेट सेक्शन में बताए गए तरीके से, allowMissing पैरामीटर के साथ monetization.subscriptions.patch तरीके का इस्तेमाल करके भी सदस्यताएं बनाई जा सकती हैं.
पहले के सभी तरीकों से, सदस्यताएं उनके बुनियादी प्लान के साथ बनाई जाती हैं. ये प्लान, Subscription ऑब्जेक्ट में दिए जाते हैं. शुरुआत में, ये बुनियादी प्लान चालू नहीं होते. बुनियादी प्लान की स्थिति मैनेज करने के लिए, monetization.subscriptions.basePlans एंडपॉइंट का इस्तेमाल किया जा सकता है. इसमें बुनियादी प्लान को चालू करना भी शामिल है, ताकि उसे खरीदारी के लिए उपलब्ध कराया जा सके. इसके अलावा, monetization.subscriptions.basePlans.offers एंडपॉइंट की मदद से, ऑफ़र बनाए और मैनेज किए जा सकते हैं.
प्रॉडक्ट के अपडेट
यहां दिए गए तरीकों की मदद से, अपने मौजूदा प्रॉडक्ट में आसानी से बदलाव किए जा सकते हैं. इससे यह पक्का किया जा सकता है कि आपके प्रॉडक्ट, आपके हाल ही में किए गए बदलावों के मुताबिक हों.
वन-टाइम प्रॉडक्ट अपडेट करना
मौजूदा वन-टाइम प्रॉडक्ट को अपडेट करने के लिए, ये तरीके उपलब्ध हैं.
- monetization.onetimeproducts.batchUpdate
inappproducts.patch: पैच एंडपॉइंट का इस्तेमाल, किसी संसाधन को आंशिक रूप से अपडेट करने के लिए किया जाता है. इसका मतलब है कि अनुरोध के मुख्य हिस्से में बताए गए फ़ील्ड अपडेट किए जा सकते हैं. पैच एंडपॉइंट का इस्तेमाल आम तौर पर तब किया जाता है, जब आपको किसी संसाधन के सिर्फ़ कुछ फ़ील्ड अपडेट करने हों.inappproducts.update: अपडेट एंडपॉइंट का इस्तेमाल, किसी संसाधन को पूरी तरह से अपडेट करने के लिए किया जाता है. इसका मतलब है कि आपको अनुरोध के मुख्य हिस्से में, पूरा रिसॉर्स ऑब्जेक्ट भेजना होगा. आम तौर पर, अपडेट एंडपॉइंट का इस्तेमाल तब किया जाता है, जब आपको किसी संसाधन के सभी फ़ील्ड अपडेट करने हों. जबallowMissingपैरामीटर कोtrueपर सेट किया जाता है और दिया गया प्रॉडक्ट आईडी पहले से मौजूद नहीं होता है, तो एंडपॉइंट, प्रॉडक्ट को इन्सर्ट कर देगा.inappproducts.batchUpdate: यह अपडेट एंडपॉइंट का बैच वर्शन है. इसकी मदद से, एक ही क्वेरी से कई प्रॉडक्ट में बदलाव किया जा सकता है. ज़्यादा थ्रूपुट पाने के लिए, इसका इस्तेमालlatencyToleranceफ़ील्ड के साथ करें. इसके लिए, फ़ील्ड कोPRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANTपर सेट करें.
शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट अपडेट करना
मौजूदा सदस्यताओं को अपडेट करने के लिए, monetization.subscriptions.patch तरीके का इस्तेमाल किया जा सकता है. इस तरीके के लिए, ये ज़रूरी पैरामीटर इस्तेमाल किए जाते हैं:
packageName: उस ऐप्लिकेशन के पैकेज का नाम जिसकी सदस्यता ली गई है.productId: सदस्यता का यूनीक प्रॉडक्ट आईडी.
regionsVersion: क्षेत्र के कॉन्फ़िगरेशन का वर्शन.
अगर allowMissing पैरामीटर का इस्तेमाल करके नई सदस्यता नहीं बनाई जा रही है, तो आपको updateMask पैरामीटर देना होगा. यह पैरामीटर, उन फ़ील्ड की कॉमा लगाकर अलग की गई लिस्ट है जिन्हें आपको अपडेट करना है.
उदाहरण के लिए, अगर आपको सिर्फ़ शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट की लिस्टिंग अपडेट करनी है, तो आपको updateMask पैरामीटर के लिए listings फ़ील्ड की जानकारी देनी होगी.
एक ही समय में कई सदस्यताओं को अपडेट करने के लिए, monetization.subscriptions.batchUpdate का इस्तेमाल किया जा सकता है.
ज़्यादा
थ्रूपुट पाने के लिए, इसका इस्तेमाल latencyTolerance फ़ील्ड के साथ करें. इसके लिए, फ़ील्ड को
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT पर सेट करें.
बुनियादी प्लान चालू करने, बंद करने, मिटाने या सदस्यों को बुनियादी प्लान की नई कीमत वाले वर्शन पर माइग्रेट करने के लिए, monetization.subscriptions.basePlans एंडपॉइंट का इस्तेमाल करें.
इसके अलावा, monetization.subscriptions.basePlans.offers.patch तरीके का इस्तेमाल करके, बुनियादी प्लान के ऑफ़र अपडेट किए जा सकते हैं.
कैटलॉग का मिलान
चाहे आपने बैकएंड के कैटलॉग में बदलाव होने पर हर बार Google Play कैटलॉग को अपडेट करने का विकल्प चुना हो या समय-समय पर अपडेट करने का विकल्प चुना हो, अगर आपके पास Google Play के कैटलॉग के अलावा कोई कैटलॉग मैनेजमेंट सिस्टम या डेटाबेस है, तो ऐसी स्थितियां हो सकती हैं जिनमें वह Play पर आपके ऐप्लिकेशन कॉन्फ़िगरेशन के कैटलॉग के साथ सिंक न हो. ऐसा हो सकता है कि Console में कैटलॉग में मैन्युअल तरीके से बदलाव किए गए हों, कैटलॉग मैनेजमेंट सिस्टम कुछ समय के लिए उपलब्ध न हो या आपका नया डेटा खो गया हो.
कैटलॉग को फिर से मिलाने की प्रोसेस बनाई जा सकती है, ताकि लंबे समय तक अंतर न रहे.
डिफ़ सिस्टम के बारे में ज़रूरी जानकारी
हमारा सुझाव है कि आप एक ऐसा सिस्टम बनाएं जो दोनों सिस्टम के बीच अंतर का पता लगा सके और उन्हें ठीक कर सके. अपने कैटलॉग को सिंक में रखने के लिए, डिफ़ सिस्टम बनाते समय इन बातों का ध्यान रखें:
- डेटा मॉडल को समझना: सबसे पहले, डेवलपर के कॉन्टेंट मैनेजमेंट सिस्टम और Google Play Developer API के डेटा मॉडल को समझें. इसमें हर सिस्टम में सेव किए गए अलग-अलग तरह के डेटा के बारे में जानना और यह समझना शामिल है कि अलग-अलग डेटा एलिमेंट एक-दूसरे से कैसे मैप होते हैं.
- डिफ़ नियम तय करना: डेटा मॉडल को समझने के बाद, आपको डिफ़ नियम तय करने होंगे. इन नियमों से यह तय होगा कि दोनों सिस्टम में मौजूद डेटा की तुलना कैसे की जाएगी. उदाहरण के लिए, हो सकता है कि आपको प्रॉडक्ट आईडी मैच करने हों. साथ ही, सदस्यता और उससे जुड़े बुनियादी प्लान और ऑफ़र के मुख्य एट्रिब्यूट की तुलना करनी हो.
- डिफ़ एल्गोरिदम लागू करना: डिफ़ के नियम तय करने के बाद, आपको डिफ़ एल्गोरिदम लागू करना होगा. यह एल्गोरिदम, दोनों सिस्टम से डेटा लेगा और आपके तय किए गए नियमों के मुताबिक उसकी तुलना करेगा. Google Play से कैटलॉग डेटा पाने के लिए,
monetization.onetimeproducts.list,monetization.onetimeproducts.batchGet,inappproducts.list,inappproducts.batchGet,monetization.subscriptions.list, औरmonetization.subscriptions.batchGetतरीकों का इस्तेमाल किया जा सकता है. - डिफ़ रिपोर्ट जनरेट करना: डिफ़ एल्गोरिदम, डिफ़ रिपोर्ट जनरेट करेगा. इस रिपोर्ट में, दोनों सिस्टम के बीच के अंतर दिखेंगे.
- अंतर को ठीक करना: अंतर की रिपोर्ट जनरेट करने के बाद, आपको अंतर को ठीक करना होगा. इसके लिए, आपको अपने कॉन्टेंट मैनेजमेंट सिस्टम में डेटा अपडेट करना पड़ सकता है. इसके अलावा, Developer API के कैटलॉग मैनेजमेंट एंडपॉइंट का इस्तेमाल करके, Google Play पर डेटा अपडेट करना पड़ सकता है. यह इस बात पर निर्भर करता है कि आम तौर पर कैटलॉग को कैसे अपडेट किया जाता है. सिंक न होने वाले प्रॉडक्ट को सिंक करने के लिए, अपडेट एंडपॉइंट का इस्तेमाल करें. इसके बारे में प्रॉडक्ट अपडेट सेक्शन में बताया गया है.
प्रॉडक्ट बंद करना
Google Play Developer API, आपके प्रॉडक्ट बंद करने में मदद करने के लिए ये तरीके उपलब्ध कराता है:
वन-टाइम प्रॉडक्ट के लिए:
monetization.onetimeproducts.deletemonetization.onetimeproducts.batchDeleteinappproducts.deleteinappproducts.batchDelete
शुल्क लेकर सदस्यता देने वाले प्रॉडक्ट के लिए:
monetization.subscriptions.deleteके लिए, सदस्यता शुल्क. कम से कम एक बुनियादी प्लान चालू होने के बाद, सदस्यता को नहीं हटाया जा सकता.
किसी प्रॉडक्ट को बंद करना कई स्थितियों में ज़रूरी हो सकता है, जैसे:
- गलती से बनाया गया.
- किसी सुविधा या सेवा को बंद करना.
हमारा सुझाव है कि आप कैटलॉग मैनेज करने की रणनीति में, प्रॉडक्ट बंद करने की प्रोसेस को शामिल करें.