प्राधिकरण

इस सेक्शन में, Google Play Developer API के लिए खास निर्देश दिए गए हैं. ज़्यादा जानकारी के लिए, OAuth2 का पूरा दस्तावेज़ देखें.

शुरुआती कॉन्फ़िगरेशन

Google Play Android Developer API को ऐक्सेस करने की पुष्टि, OAuth 2.0 वेब सर्वर फ़्लो का इस्तेमाल करके की जाती है. एपीआई का इस्तेमाल करने से पहले, आपको APIs Console प्रोजेक्ट सेट अप करना होगा. साथ ही, क्लाइंट आईडी बनाना होगा और रीफ़्रेश टोकन जनरेट करना होगा.

APIs Console प्रोजेक्ट बनाना

1. APIs Console पर जाएं और अपने Google Play Console खाते से लॉग इन करें.
2. प्रोजेक्ट बनाएं को चुनें.
3. बाईं ओर मौजूद नेविगेशन पैनल में, सेवाएं पर जाएं.
4. Google Play Android Developer API चालू करें.
5. सेवा की शर्तें स्वीकार करें.
6. बाईं ओर मौजूद नेविगेशन पैनल में, एपीआई ऐक्सेस पर जाएं.
7. OAuth 2.0 क्लाइंट आईडी बनाएं को चुनें.
   • पहले पेज पर, आपको प्रॉडक्ट का नाम डालना होगा. हालांकि, लोगो डालना ज़रूरी नहीं है. ध्यान दें कि असली उपयोगकर्ताओं को प्रॉडक्ट का नाम नहीं दिखेगा.
   • दूसरे पेज पर, वेब ऐप्लिकेशन चुनें. इसके बाद, रीडायरेक्ट यूआरआई और JavaScript ऑरिजिन सेट करें. इन दोनों सेटिंग को बाद में बदला जा सकता है.
8. क्लाइंट आईडी बनाएं को चुनें.

रीफ़्रेश टोकन जनरेट करना

1. Google Play Console खाते से लॉग इन करने के बाद, इस यूआरआई पर जाएं:

   https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/androidpublisher&response_type=code&access_type=offline&redirect_uri=...&client_id=...

   ध्यान दें: redirect_uri पैरामीटर की वैल्यू, क्लाइंट आईडी के साथ रजिस्टर की गई वैल्यू से पूरी तरह मेल खानी चाहिए. इसमें आखिर में मौजूद बैकस्लैश भी शामिल है, अगर मौजूद हो.
2. जब आपसे अनुमति मांगी जाए, तब ऐक्सेस की अनुमति दें को चुनें.
3. ब्राउज़र को आपके रीडायरेक्ट यूआरआई पर code पैरामीटर के साथ रीडायरेक्ट किया जाएगा. यह 4/eWdxD7b-YSQ5CNNb-c2iI83KQx19.wp6198ti5Zc7dJ3UXOl0T3aRLxQmbwI जैसा दिखेगा.
4. इस कोड को ऐक्सेस और रीफ़्रेश टोकन के जोड़े के लिए बदलें. इसके लिए, https://accounts.google.com/o/oauth2/token को POST अनुरोध भेजें. साथ ही, इन फ़ील्ड को सेट करें:

   grant_type=authorization_code
   code=<the code from the previous step>
   client_id=<the client ID token created in the APIs Console>
   client_secret=<the client secret corresponding to the client ID>
   redirect_uri=<the URI registered with the client ID>
   

   सही रिस्पॉन्स में, आपके टोकन JSON फ़ॉर्मैट में शामिल होंगे:

   {
     "access_token" : "ya29.ZStBkRnGyZ2mUYOLgls7QVBxOg82XhBCFo8UIT5gM",
     "token_type" : "Bearer",
     "expires_in" : 3600,
     "refresh_token" : "1/zaaHNytlC3SEBX7F2cfrHcqJEa3KoAHYeXES6nmho"
   }
   

एपीआई को ऐक्सेस करना

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

ऐक्सेस टोकन का इस्तेमाल करना

सर्वर, एपीआई को कॉल कर सकते हैं. इसके लिए, उन्हें अनुरोध के Authorization हेडर में ऐक्सेस टोकन पास करना होगा:

Authorization: Bearer oauth2-token

रीफ़्रेश टोकन का इस्तेमाल करना

हर ऐक्सेस टोकन, कुछ ही समय के लिए मान्य होता है. मौजूदा ऐक्सेस टोकन की समयसीमा खत्म होने के बाद, सर्वर को नया टोकन पाने के लिए रीफ़्रेश टोकन का इस्तेमाल करना होगा. इसके लिए, https://accounts.google.com/o/oauth2/token को POST अनुरोध भेजें. इसमें ये फ़ील्ड सेट होने चाहिए:

grant_type=refresh_token
client_id=<the client ID token created in the APIs Console>
client_secret=<the client secret corresponding to the client ID>
refresh_token=<the refresh token from the previous step>

सफल जवाब में एक और ऐक्सेस टोकन शामिल होगा:

{
  "access_token" : "ya29.AHES3ZQ_MbZCwac9TBWIbjW5ilJkXvLTeSl530Na2",
  "token_type" : "Bearer",
  "expires_in" : 3600,
}

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