शुरू करना

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

  1. अपने डेवलपर खाते को किसी नए या मौजूदा Google Cloud प्रोजेक्ट से जोड़ें.
  2. अपने लिंक किए गए Google Cloud प्रोजेक्ट के लिए, Google Play डेवलपर एपीआई चालू करें.
  3. अपने लिंक किए गए Google Cloud प्रोजेक्ट में, Google Play डेवलपर API (एपीआई) को एपीआई कुंजी की अनुमति दें.
  4. Google Play डेवलपर एपीआई को ऐक्सेस करने के लिए, Google Play Console से जुड़ी सही अनुमतियां सेट करें और सेवा खाता सेट अप करें.

अपना खाता और प्रोजेक्ट लिंक करना

Google Play डेवलपर API (एपीआई) को ऐक्सेस करने से पहले, आपको अपने Google Play डेवलपर खाते को किसी Google क्लाउड प्रोजेक्ट से जोड़ना होगा. ज़्यादातर मामलों में, हमारा सुझाव है कि आप Google Play डेवलपर खाते के लिए बना एक नया Google Cloud प्रोजेक्ट बनाएं. हालांकि, किसी मौजूदा प्रोजेक्ट को लिंक किया जा सकता है. ध्यान रखें कि हर Google Play डेवलपर खाते को सिर्फ़ एक Google Cloud प्रोजेक्ट के साथ जोड़ा जा सकता है. अगर आपके पास एक ही Google Play डेवलपर खाते में एक से ज़्यादा ऐप्लिकेशन हैं, तो उन सभी को एक ही Google Cloud प्रोजेक्ट शेयर करना होगा.

नया प्रोजेक्ट बनाएं

  1. Google Play Console में एपीआई ऐक्सेस पेज पर जाएं.
  2. नया प्रोजेक्ट बनाएं पर क्लिक करें.

Google Cloud प्रोजेक्ट अपने-आप बन जाता है और आपके Google Play डेवलपर खाते से लिंक हो जाता है.

किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना

अगर आप पहले से ही Google Cloud Console के उपयोगकर्ता हैं, तो यह तरीका अपनाकर अपने मौजूदा Google Cloud प्रोजेक्ट को लिंक करें:

  1. Google Play Console में एपीआई ऐक्सेस पेज पर जाएं.
  2. वह प्रोजेक्ट चुनें जिसे आप लिंक करना चाहते हैं. अगर आपका प्रोजेक्ट सूची में शामिल नहीं है, तो पुष्टि करें कि आपके Google खाते को Google Cloud प्रोजेक्ट में मालिक के तौर पर मान्यता दी गई है.
  3. मौजूदा प्रोजेक्ट लिंक करें पर क्लिक करें.

एपीआई चालू करें

लिंक किए गए Google Cloud के प्रोजेक्ट को सेट अप करने के बाद, आपको इस प्रोजेक्ट के लिए Google Play डेवलपर API को चालू करना होगा. ऐसा करने के लिए, यह ज़रूरी है कि आप Google Cloud प्रोजेक्ट के मालिक हों.

  1. Google Play Console में एपीआई ऐक्सेस पेज पर जाएं.
  2. एपीआई में जाकर, Google Play डेवलपर एपीआई ढूंढें और चालू करें पर क्लिक करें.

ऐसा करने से, Google Cloud प्रोजेक्ट सीधे तौर पर अपडेट हो जाता है. बदलाव तुरंत लागू हो जाता है.

एपीआई कुंजी को अनुमति देना

एपीआई का इस्तेमाल करने के लिए, आपको अपने लिंक किए गए Google Cloud प्रोजेक्ट में एक एपीआई कुंजी की ज़रूरत होगी. साथ ही, उसे Google Play डेवलपर API (एपीआई) का इस्तेमाल करने की अनुमति मिली हुई है. इसे Google Play Console में सेट अप करें.

OAuth और सेवा खाते कॉन्फ़िगर करना

आपको Google Play डेवलपर API (एपीआई) का ऐक्सेस OAuth क्लाइंट या सेवा खाते के साथ कॉन्फ़िगर करना होगा. ज़्यादातर मामलों में, एपीआई को ऐक्सेस करने के लिए आपको सेवा खाते का इस्तेमाल करना चाहिए.

सेवा खातों का इस्तेमाल किसी सुरक्षित परिवेश में किया जाना चाहिए, जैसे कि आपका सर्वर. सेवा खाते के क्रेडेंशियल को सुरक्षित रूप से मैनेज करना ज़रूरी है, ताकि वे ऐसे किसी भी व्यक्ति के लिए ज़ाहिर न हों जिसे एपीआई का इस्तेमाल करने की अनुमति नहीं है.

अगर आपको किसी व्यक्तिगत उपयोगकर्ता की ओर से एपीआई का ऐक्सेस चाहिए, तो OAuth क्लाइंट आईडी का इस्तेमाल किया जाना चाहिए. उदाहरण के लिए, अगर आपकी वेबसाइट को उपयोगकर्ता की ओर से वेब क्लाइंट के लिए Google Play डेवलपर एपीआई को ऐक्सेस करना है, तो क्लाइंट आईडी का इस्तेमाल किया जा सकता है. सेवा खाते के बजाय, उस उपयोगकर्ता की पुष्टि Google खाते से की जाएगी. इससे आप सेवा खाते के क्रेडेंशियल से समझौता किए बिना, उपयोगकर्ता की ओर से एपीआई कॉल कर सकते हैं.

  • सेवा खाता: एक सुरक्षित सॉफ़्टवेयर सेवा, एपीआई को ऐक्सेस करेगी (सबसे आम)
  • OAuth क्लाइंट: कोई उपयोगकर्ता, एपीआई को ऐक्सेस करेगा

सेवा खाते का इस्तेमाल करना

आप Google Play Console से एक सेवा खाता बना सकते हैं.

  1. Google Play Console में एपीआई ऐक्सेस पेज पर जाएं.
  2. सेवा खाते में जाकर, सेवा खाते बनाने का तरीका जानें पर क्लिक करें.

  3. अपना सेवा खाता बनाने के लिए, निर्देशों का पालन करें.

    खाता बनाने की प्रोसेस के दौरान आपको अपने सेवा खाते को Google Cloud प्रोजेक्ट का ऐक्सेस देना होगा, ताकि वह Google Play Console में दिखे.

  4. Google Play Console पर सेवा खाता बनाने के बाद, हो गया पर क्लिक करें. एपीआई ऐक्सेस पेज का सेवा खाता सेक्शन, अपने-आप रीफ़्रेश हो जाता है और आपका सेवा खाता सूची में शामिल हो जाता है.

  5. सेवा खाते को कार्रवाइयां करने के ज़रूरी अधिकार देने के लिए, ऐक्सेस दें पर क्लिक करें.

    Google Play Billing API का इस्तेमाल करने के लिए, आपको नीचे दी गई अनुमतियां देनी होंगी:

    • वित्तीय डेटा, ऑर्डर, और रद्द करने के बारे में हुए सर्वे में मिले जवाब देखना
    • ऑर्डर और सदस्यताएं मैनेज करना

इस समय, आप सेवा खाते के ज़रिए Google Play डेवलपर API ऐक्सेस कर सकते हैं. ज़्यादा जानकारी के लिए, सर्वर ऐप्लिकेशन के लिए सर्वर के लिए OAuth 2.0 का इस्तेमाल करना देखें.

OAuth क्लाइंट का इस्तेमाल करना

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

OAuth क्लाइंट बनाने से पहले, आपको अपने प्रॉडक्ट की ब्रैंडिंग जानकारी कॉन्फ़िगर करनी होगी. ज़्यादा जानकारी के लिए, OAuth की सहमति वाली स्क्रीन सेट अप करना देखें.

  1. Google Play Console में एपीआई ऐक्सेस पेज पर जाएं.
  2. OAuth क्लाइंट में, OAuth सहमति स्क्रीन कॉन्फ़िगर करें पर क्लिक करें.
  3. अपने प्रॉडक्ट की ब्रैंडिंग जानकारी कॉन्फ़िगर करें.
  4. इसके बाद, OAuth की सहमति रीफ़्रेश करें पर क्लिक करें. आपको यह सेक्शन अपडेट करना होगा. इसके बाद, आपको ब्रैंडिंग से जुड़ी जानकारी वाला मैसेज नहीं दिखेगा.

Google Play Console का इस्तेमाल करके OAuth क्लाइंट बनाने के लिए:

  1. Google Play Console में एपीआई ऐक्सेस पेज पर जाएं.
  2. OAuth क्लाइंट में, नया OAuth क्लाइंट बनाएं पर क्लिक करें.
  3. अपना OAuth क्लाइंट बनाने के लिए, पेज पर दिए गए निर्देशों का पालन करें.

  4. Google Play Console पर OAuth क्लाइंट बनाने के बाद, हो गया पर क्लिक करें. एपीआई ऐक्सेस पेज का OAuth क्लाइंट सेक्शन अपने-आप रीफ़्रेश हो जाता है और आपका OAuth क्लाइंट सूची में शामिल हो जाता है.

    कभी-कभी नया OAuth क्लाइंट, पेज पर तुरंत नहीं दिखता. उस मामले में, OAuth क्लाइंट को रीफ़्रेश करें पर क्लिक करें.

आपके नए OAuth क्लाइंट की जानकारी, इस पेज पर दी गई सूची में दिखेगी.

अन्य जानकारी

Google Play पर एपीआई का इस्तेमाल शुरू करने के लिए, इन सुझावों और तरकीबों का इस्तेमाल करें.

अपना डेवलपर आईडी पाना

कुछ एपीआई के लिए, आपको Google Play Console डेवलपर आईडी देना होगा. यह एक लंबी संख्या है जो आपका Google Play डेवलपर खाता बनाते समय असाइन किया गया था. आपका डेवलपर आईडी, Google Play Console पर मौजूद किसी भी पेज के यूआरएल में देखा जा सकता है. जैसे, एपीआई ऐक्सेस पेज.

उदाहरण के लिए, Google Play Console के यूआरएल पर विचार करें:

https://play.google.com/console/developers/1234567890123456789/api-access

ऊपर दिए गए यूआरएल में, डेवलपर आईडी 1234567890123456789 होगा.

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

खास एपीआई

Google Play डेवलपर एपीआई में कई खास एपीआई शामिल होते हैं. इनकी मदद से आप अपने ऐप्लिकेशन पर खास तरह के विश्लेषण कर सकते हैं:

Reviews API का जवाब दें
इससे, आपको अपने ऐप्लिकेशन के लिए उपयोगकर्ता के सुझाव देखने और इस सुझाव का जवाब देने की सुविधा मिलती है.
खरीदारी के लिए इस्तेमाल होने वाले प्रॉडक्ट का एपीआई
आपको उन खरीदारी से जुड़े ऐप्लिकेशन में खरीदने के लिए प्रॉडक्ट के ऐक्सेस को निरस्त करने देता है जिन्हें उपयोगकर्ता ने रद्द कर दिया है.

क्लाइंट लाइब्रेरी

हमने क्लाइंट लाइब्रेरी उपलब्ध कराई हैं. इनका इस्तेमाल करके, आप REST API के किसी प्रोग्राम को ऐक्सेस कर सकते हैं. ज़्यादा जानकारी के लिए, क्लाइंट लाइब्रेरी और कोड सैंपल देखें.