Google Play डेवलपर एपीआई

खास जानकारी

Google Play Console, REST-आधारित वेब सेवा एपीआई का एक सुइट उपलब्ध कराता है. इसकी मदद से, सीधे अपने ऐप्लिकेशन के लिए पब्लिश करने, रिपोर्टिंग, और ऐप्लिकेशन मैनेज करने से जुड़े अन्य फ़ंक्शन किए जा सकते हैं.

सभी डेवलपर को इन डेवलपर एपीआई का इस्तेमाल करने की ज़रूरत नहीं है — ज़्यादातर मामलों में, सीधे Google Play Console का इस्तेमाल करके अपने ऐप्लिकेशन मैनेज किए जा सकते हैं. हालांकि, अगर आपको बड़ी संख्या में एपीके मैनेज करने हैं या उपयोगकर्ता की खरीदारी और सदस्यताओं को ट्रैक करना है, तो आपको ये एपीआई काम के लग सकते हैं.

ये चीज़ें शामिल हैं

Google Play डेवलपर एपीआई की मदद से, आपको अपने ऐप्लिकेशन को डिज़ाइन और डेवलप करने पर फ़ोकस करने में मदद मिलती है. साथ ही, नए बाज़ारों में अपने ऐप्लिकेशन को बढ़ाने के लिए, रिलीज़ को मैनेज करने में कम समय और मेहनत लगती है.

Google Play Console में एपीआई का एक सुइट शामिल होता है. इसका इस्तेमाल करके, अपने ऐप्लिकेशन को मैनेज किया जा सकता है:

• Publishing API की मदद से, ऐप्लिकेशन अपलोड और पब्लिश किए जा सकते हैं. साथ ही, पब्लिश करने से जुड़े अन्य काम भी किए जा सकते हैं.
• Subscriptions and In-App Purchases API की मदद से, इन-ऐप्लिकेशन खरीदारी और सदस्यताओं को मैनेज किया जा सकता है. (इसे पहले "Purchase Status API" कहा जाता था.)
• Reporting API की मदद से, 'Android की ज़रूरी जानकारी' से अपने ऐप्लिकेशन की क्वालिटी के बारे में जानकारी हासिल की जा सकती है.
• 'समीक्षाओं का जवाब दें' एपीआई की मदद से, अपने ऐप्लिकेशन की समीक्षाएं हासिल की जा सकती हैं और उनका जवाब दिया जा सकता है.
• Permissions API की मदद से, Play Console में अनुमतियों को अपने-आप मैनेज किया जा सकता है.
• Play Games Services Management API की मदद से, प्रोग्राम के हिसाब से Google Play Games Services की सुविधाओं के लिए मौजूद मेटाडेटा को कंट्रोल किया जा सकता है. इसके लिए, आपको REST कॉल जारी करने होंगे.
• रद्द की गई खरीदारी का एपीआई, उन ऑर्डर की सूची उपलब्ध कराता है जो उपयोगकर्ता ने रद्द कर दिए हैं.

शुरू करना

Google Play Developer API का इस्तेमाल शुरू करने के लिए, शुरू करने से जुड़ा दस्तावेज़ देखें.

प्रकाशन API

Publishing API की मदद से, ऐप्लिकेशन उपलब्ध कराने से जुड़े बार-बार किए जाने वाले कामों को अपने-आप होने के लिए सेट किया जा सकता है. इसमें वे फ़ंक्शन मिलते हैं जो डेवलपर को Play Console में मिलते हैं. जैसे:

• ऐप्लिकेशन के नए वर्शन अपलोड करना
• APKs को अलग-अलग ट्रैक (ऐल्फ़ा, बीटा, कुछ लोगों के लिए की गई रिलीज़ या प्रोडक्शन) पर असाइन करके, ऐप्लिकेशन रिलीज़ करना
• Google Play Store पर स्टोर पेज बनाना और उनमें बदलाव करना. इसमें स्थानीय भाषा में लिखा गया टेक्स्ट, ग्राफ़िक, और अलग-अलग डिवाइसों के स्क्रीनशॉट शामिल हैं

ये टास्क, बदलाव की सुविधा का इस्तेमाल करके किए जाते हैं. इस सुविधा की मदद से, बदलाव करने के लिए ट्रांज़ैक्शनल तरीके का इस्तेमाल किया जाता है. इसकी मदद से, कई बदलावों को एक ही ड्राफ़्ट में बंडल किया जा सकता है. इसके बाद, सभी बदलावों को एक साथ लागू किया जा सकता है. (बदलाव तब तक लागू नहीं होते, जब तक कि बदलाव को स्वीकार नहीं किया जाता.)

ध्यान दें: सभी डेवलपर को इस एपीआई का इस्तेमाल करने की ज़रूरत नहीं है. एपीआई की सभी सुविधाएं, Google Play Console से भी ऐक्सेस की जा सकती हैं. हालांकि, इस एपीआई की मदद से, अपने ऐप्लिकेशन और लिस्टिंग को अपडेट करने की प्रोसेस को अपने मौजूदा टूल के साथ इंटिग्रेट किया जा सकता है. यह सुविधा कुछ डेवलपर के लिए फ़ायदेमंद है. खास तौर पर, अगर आपको कई APK मैनेज करने हैं या कई अलग-अलग भाषाओं में स्थानीय भाषा के हिसाब से बनाई गई लिस्टिंग मैनेज करनी हैं, तो आपको यह एपीआई काफ़ी मददगार लग सकता है.

सबसे सही तरीके

• ऐप्लिकेशन के अपडेट की संख्या सीमित करें. अल्फा या बीटा वर्शन के अपडेट, दिन में एक से ज़्यादा बार पब्लिश न करें. प्रोडक्शन ऐप्लिकेशन को इससे भी कम बार अपडेट किया जाना चाहिए. हर अपडेट के लिए, आपके उपयोगकर्ताओं को समय और शायद पैसे भी खर्च करने पड़ते हैं. अगर ऐप्लिकेशन को बार-बार अपडेट किया जाता है, तो हो सकता है कि उपयोगकर्ता अपडेट को अनदेखा करना शुरू कर दें या ऐप्लिकेशन को अनइंस्टॉल कर दें.

Subscriptions and In-App Purchases API

Subscriptions and In-App Purchases API की मदद से, ऐप्लिकेशन में खरीदने के लिए उपलब्ध प्रॉडक्ट और सदस्यताओं का कैटलॉग मैनेज किया जा सकता है. इसके अलावा, Subscriptions और In-app Purchases API की मदद से, किसी भी खरीदारी की जानकारी तुरंत हासिल की जा सकती है. इसके लिए, आपको स्टैंडर्ड GET अनुरोध का इस्तेमाल करना होगा.

अनुरोध में, आपको खरीदारी के बारे में जानकारी देनी होगी — ऐप्लिकेशन पैकेज का नाम, खरीदारी या सदस्यता आईडी, और खरीदारी टोकन. सर्वर, JSON ऑब्जेक्ट के साथ जवाब देता है. इसमें खरीदारी की जानकारी, ऑर्डर की स्थिति, डेवलपर पेलोड, और अन्य जानकारी शामिल होती है.

इस एपीआई का इस्तेमाल कई तरीकों से किया जा सकता है. जैसे, अलग-अलग ऑर्डर की रिपोर्टिंग और उनका मिलान करने के लिए. साथ ही, खरीदारी और सदस्यता की समयसीमा खत्म होने की पुष्टि करने के लिए भी इसका इस्तेमाल किया जा सकता है. रद्द किए गए ऑर्डर के बारे में जानने और यह पुष्टि करने के लिए भी एपीआई का इस्तेमाल किया जा सकता है कि इन-ऐप्लिकेशन प्रॉडक्ट इस्तेमाल किए गए हैं या नहीं. साथ ही, यह भी पुष्टि की जा सकती है कि रद्द किए जाने से पहले, इन प्रॉडक्ट का इस्तेमाल किया गया था या नहीं.

ध्यान दें: Subscriptions and In-App Purchases API, लेन-देन से जुड़े "बदलाव" की उस सुविधा का इस्तेमाल नहीं करता जिसका इस्तेमाल Publishing API करता है. Inappproducts और Purchases.subscriptions संसाधनों के लिए, तरीके तुरंत लागू हो जाते हैं. हर संसाधन के एपीआई रेफ़रंस पेज पर, यह जानकारी दी जाती है कि उस संसाधन के तरीके "बदलाव" मॉडल का इस्तेमाल करते हैं या नहीं.

सबसे सही तरीके

• अपने सर्वर पर सदस्यता की जानकारी सेव करें, ताकि एपीआई के ग़ैर-ज़रूरी कॉल से बचा जा सके. जब आपके ऐप्लिकेशन को किसी सदस्यता की पुष्टि करनी हो, तो आपको Google को API कॉल दोहराने के बजाय, अपने सर्वर पर कैश मेमोरी में सेव की गई जानकारी पर भरोसा करना चाहिए.
• सदस्यता की जानकारी पाने के लिए, आपके सुरक्षित सर्वर को Google Play Developer API का इस्तेमाल करने की ज़रूरत इन दो स्थितियों में पड़ती है:
  • आपके सर्वर को एक नया खरीदारी टोकन मिलता है, जो पहले कभी नहीं देखा गया है.
  • आपके सर्वर को डेवलपर से जुड़ी रीयल-टाइम सूचना (आरटीडीएन) मिलती है. इससे पता चलता है कि आपको सदस्यता की नई जानकारी पाने के लिए, परचेज़ टोकन का इस्तेमाल करना होगा.
• सदस्यता की स्थिति के लिए, नियमित तौर पर एपीआई को पोल न करें. उदाहरण के लिए, हर सदस्यता की जांच करने के लिए, एपीआई को हर दिन कॉल न करें.
• सदस्यता की समयसीमा खत्म होने या रिन्यू होने पर, आपको आरटीडीएन मिलता है. इसलिए, आपको सदस्यता की समयसीमा खत्म होने के शेड्यूल किए गए समय के आधार पर, एपीआई कॉल शेड्यूल करने की ज़रूरत नहीं है.

API को रिपोर्ट कर रहा है

Reporting API, उन डेवलपर के लिए है जो Play Console के डेटा के आधार पर, अपने-आप काम करने वाले वर्कफ़्लो बनाना चाहते हैं. इसके अलावा, यह उन डेवलपर के लिए भी है जो अपने कारोबार की रिपोर्टिंग और विश्लेषण के लिए, Play Console के डेटा का इस्तेमाल करते हैं. ऐसा, अन्य डेटासेट के साथ भी किया जा सकता है. इससे आपको ऐप्लिकेशन लेवल के डेटा का ऐक्सेस मिलता है. साथ ही, आपको इंटरनल रिपोर्टिंग, विश्लेषण, और ऑटोमेशन की मेट्रिक का ऐक्सेस भी मिलता है. डेटा और मेट्रिक का यह ऐक्सेस, प्रोग्राम के हिसाब से अपने-आप दिया जाता है.

रिपोर्टिंग एपीआई, 'Android की ज़रूरी जानकारी' से जुड़े डेटा का ऐक्सेस देता है. इसमें क्रैश रेट, ANR रेट, डिवाइस के चालू होने और उसे चालू रखने से जुड़ी समस्याएं, और गड़बड़ी के स्टैक ट्रेस शामिल हैं.

सबसे सही तरीके

• Reporting API के इस वर्शन में, हर सेकंड 10 क्वेरी करने की डिफ़ॉल्ट सीमा होती है. Google Cloud Console के कोटा सेक्शन में जाकर, कोटे के इस्तेमाल की जानकारी देखी जा सकती है. अगर आपको इस सीमा से ज़्यादा क्वोटा चाहिए, तो यह फ़ॉर्म भरकर अनुरोध सबमिट करें.

Reply to Reviews API

समीक्षाओं का जवाब दें एपीआई की मदद से, अपने ऐप्लिकेशन के लिए उपयोगकर्ताओं का सुझाव, शिकायत या राय देखी जा सकती है. साथ ही, इस सुझाव, शिकायत या राय का जवाब भी दिया जा सकता है. इस एपीआई का इस्तेमाल करके, सीधे अपने मौजूदा ग्राहक सहायता टूलकिट, जैसे कि सीआरएम सिस्टम में उपयोगकर्ताओं से इंटरैक्ट किया जा सकता है.

'समीक्षाओं का जवाब दें' एपीआई की मदद से, सिर्फ़ अपने ऐप्लिकेशन के प्रोडक्शन वर्शन के लिए सुझाव, शिकायत या राय देखी जा सकती है. अगर आपको अपने ऐप्लिकेशन के अल्फा या बीटा वर्शन के लिए सुझाव, शिकायत या राय देखनी है, तो इसके लिए Google Play Console का इस्तेमाल करें. यह भी ध्यान रखें कि एपीआई सिर्फ़ ऐसी समीक्षाएं दिखाता है जिनमें टिप्पणियां शामिल हों. अगर कोई उपयोगकर्ता आपके ऐप्लिकेशन को रेटिंग देता है, लेकिन कोई टिप्पणी नहीं करता है, तो उसके सुझाव/राय/शिकायत को एपीआई से ऐक्सेस नहीं किया जा सकता.

Permissions API

Permissions API की मदद से, डेवलपर Play Console में अनुमतियों को अपने-आप मैनेज करने की सुविधा चालू कर सकते हैं. इससे, आपको यह कंट्रोल करने में मदद मिलती है कि आपके डेवलपर खाते का ऐक्सेस किन लोगों के पास है. इसके लिए, आपको मैन्युअल रूप से कुछ करने की ज़रूरत नहीं है.

Permissions API की मदद से, एडमिन के तौर पर ये काम किए जा सकते हैं:

• जब उपयोगकर्ता आपकी कंपनी छोड़ते हैं, तब उनके ऐक्सेस को हटाना.
• जब कोई उपयोगकर्ता किसी टीम में शामिल होता है, तो उसे ऐप्लिकेशन का ऐक्सेस देना.

Voided purchases API

रद्द की गई खरीदारी का एपीआई, उन ऑर्डर की सूची उपलब्ध कराता है जो उपयोगकर्ता ने रद्द किए हैं. इस सूची की जानकारी का इस्तेमाल करके, रद्द करने की सुविधा लागू की जा सकती है. इससे, उपयोगकर्ता उन ऑर्डर के प्रॉडक्ट ऐक्सेस नहीं कर पाएगा.

यह एपीआई, ऐप्लिकेशन में एक बार किए जाने वाले ऑर्डर और ऐप्लिकेशन की सदस्यताओं पर लागू होता है.

खरीदारी को इन तरीकों से रद्द किया जा सकता है:

• उपयोगकर्ता अपने ऑर्डर के लिए रिफ़ंड का अनुरोध करता है.
• उपयोगकर्ता अपना ऑर्डर रद्द कर देता है.
• किसी ऑर्डर के लिए किया गया पेमेंट, खाते में वापस आना.
• डेवलपर, ऑर्डर रद्द करता है या रिफ़ंड देता है. ध्यान दें: रद्द की गई खरीदारी के एपीआई में सिर्फ़ रद्द किए गए ऑर्डर दिखेंगे. अगर डेवलपर, रद्द करने का विकल्प सेट किए बिना रिफ़ंड करता है, तो ऑर्डर एपीआई में नहीं दिखेंगे.
• Google, ऑर्डर रद्द कर देता है या रिफ़ंड दे देता है.

इस एपीआई का इस्तेमाल करके, अपने ऐप्लिकेशन के सभी उपयोगकर्ताओं के लिए बेहतर अनुभव दिया जा सकता है. खास तौर पर, अगर आपका ऐप्लिकेशन कोई गेम है, तो यह ज़रूरी है कि सभी उपयोगकर्ताओं को एक जैसा अनुभव मिले.