आरंभ करना

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

  1. Google Cloud प्रोजेक्ट बनाएं.
  2. अपने Google Cloud प्रोजेक्ट के लिए, Google Play Developer API चालू करें.
  3. Google Play Developer API को ऐक्सेस करने के लिए, Google Play Console की ज़रूरी अनुमतियों के साथ एक सेवा खाता सेट अप करें.

Google Cloud प्रोजेक्ट बनाना

अगर आपके पास पहले से कोई Google Cloud प्रोजेक्ट है और आपको उसका इस्तेमाल करना है, तो इस चरण को छोड़ा जा सकता है.

Google Cloud Console में एक प्रोजेक्ट बनाएं.

Google Cloud प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, प्रोजेक्ट बनाना और मैनेज करना लेख पढ़ें.

एपीआई चालू करना

Google Cloud प्रोजेक्ट सेट अप करने के बाद, आपको इस प्रोजेक्ट के लिए Google Play Developer API चालू करना होगा.

Google Play Developer API चालू करने के लिए:

  1. Google Cloud Console में, Google Play Developer API पेज पर जाएं.
  2. चालू करें पर क्लिक करें.

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

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

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

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

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

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

Google Play Console में जाकर, सेवा खाता बनाया जा सकता है.

  1. Google Cloud Console में, सेवा खाते पर जाएं.
  2. सेवा खाता बनाएं पर क्लिक करें और निर्देशों का पालन करें.
  3. Google Play Console में, उपयोगकर्ता और अनुमतियां पेज पर जाएं.
  4. नए उपयोगकर्ताओं को न्योता भेजें पर क्लिक करें.

  5. ईमेल पते वाले फ़ील्ड में, अपने सेवा खाते का ईमेल पता डालें. साथ ही, कार्रवाइयां करने के लिए ज़रूरी अनुमतियां दें.

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

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

  6. उपयोगकर्ता को न्योता भेजें पर क्लिक करें.

इस समय, आपको सेवा खाते के ज़रिए Google Play Developer API को ऐक्सेस करने का विकल्प मिल जाएगा. ज़्यादा जानकारी के लिए, सर्वर से सर्वर के बीच कम्यूनिकेट करने वाले ऐप्लिकेशन के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

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

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

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

  1. Google Cloud Console में, OAuth के लिए सहमति देने की स्क्रीन वाले पेज पर जाएं.
  2. OAuth के लिए सहमति लेने वाली स्क्रीन बनाने के लिए यह तरीका अपनाएं.

OAuth क्लाइंट बनाने के लिए:

  1. Google Cloud Console में, क्रेडेंशियल पर जाएं.
  2. क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
  3. आवेदन का टाइप चुनें और निर्देशों का पालन करें.

अतिरिक्त जानकारी

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 Developer API में कई खास एपीआई शामिल हैं. इनकी मदद से, अपने ऐप्लिकेशन का खास तरह का विश्लेषण किया जा सकता है:

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

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

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