पहले से तैयार डिवाइस रीसेलर एपीआई को एपीआई कॉल के लिए अनुमति की ज़रूरत है. अनुमति देने की प्रक्रिया से आपके संगठन का डेटा सुरक्षित रहता है. पहले से तैयार डिवाइस वाले एपीआई को कॉल करने की अनुमति देने के लिए, आपको नीचे दिए गए काम पूरे करने होंगे:
- एपीआई को कॉल करने के लिए, सेवा खाता बनाएं.
- एपीआई कॉल को अनुमति देने के लिए, JSON कुंजी फ़ाइल सेव करें.
- एपीआई को चालू करें, ताकि इसे सेवा खाते के लिए उपलब्ध कराया जा सके.
- अपने संगठन की तरफ़ से एपीआई कॉल करने के लिए, सेवा खाते को लिंक करें.
टास्क पूरे करने के लिए, नीचे दिए गए निर्देशों का पालन करें.
पहला चरण: सेवा खाता बनाना
सेवा खाता, कभी-कभी रोबोट खाता कहा जाता है. यह उपयोगकर्ताओं के बजाय ऐप्लिकेशन दिखाने वाला Google खाता होता है. आपका ऐप्लिकेशन, सेवा खाते की ओर से एपीआई को कॉल करता है. आपका ऐप्लिकेशन Google API का इस्तेमाल कर रहा है. इसलिए, ऐक्सेस सेट अप करने के लिए Google API (एपीआई) कंसोल का इस्तेमाल करें.
कोई एपीआई कंसोल प्रोजेक्ट बनाना
अपने ऐप्लिकेशन के लिए नया एपीआई कंसोल प्रोजेक्ट और सेवा खाता बनाना अच्छा रहता है. इससे, भविष्य में ऐक्सेस को मैनेज करना, संसाधनों को मैनेज करना, और खोई हुई कुंजियों को ठीक करना आसान हो जाता है. Google API (एपीआई) कंसोल में नया प्रोजेक्ट बनाने के लिए, नीचे दिया गया तरीका अपनाएं:
- एपीआई कंसोल पर जाएं.
- प्रोजेक्ट की सूची में से, प्रोजेक्ट बनाएं को चुनें.
- एक ऐसा नाम डालें, जो आपके ऐप्लिकेशन और पहले से तैयार डिवाइस की जानकारी देता हो.
- प्रोजेक्ट आईडी डालें या डिफ़ॉल्ट प्रोजेक्ट स्वीकार करें.
- बनाएं पर क्लिक करें.
ज़्यादा जानने के लिए, Google Cloud Platform दस्तावेज़ कंसोल में प्रोजेक्ट मैनेज करें पढ़ें.
नए सेवा क्रेडेंशियल जोड़ें
अपने प्रोजेक्ट में नए क्रेडेंशियल और सेवा खाता जोड़ने के लिए, अपने एपीआई कंसोल में नीचे दिए गए तरीके अपनाएं.
- सेवा खाते का पेज खोलें. पूछे जाने पर, प्रोजेक्ट चुनें.
- सेवा खाता बनाएं पर क्लिक करें, सेवा खाते का नाम और जानकारी डालें. आप डिफ़ॉल्ट सेवा खाता आईडी इस्तेमाल करें या फिर कोई दूसरा, अलग खाता आईडी चुनें. काम पूरा हो जाने पर, बनाएं पर क्लिक करें.
- इसके बाद आने वाले सेवा खाते की अनुमतियां (ज़रूरी नहीं) सेक्शन की ज़रूरत नहीं है. जारी रखें पर क्लिक करें.
- उपयोगकर्ताओं को इस खाते का ऐक्सेस दें स्क्रीन पर, नीचे कुंजी बनाएं सेक्शन तक स्क्रोल करें. कुंजी बनाएं पर क्लिक करें.
- इसके बाद, जो साइड पैनल दिखेगा उसमें अपनी कुंजी का फ़ॉर्मैट चुनें: JSON का सुझाव दिया जाता है.
- बनाएं पर क्लिक करें. आपकी नई सार्वजनिक/निजी कुंजी की जोड़ी जनरेट करके आपकी मशीन पर डाउनलोड की जाती है. यह इस कुंजी की अकेली कॉपी की तरह काम करती है. इसे सुरक्षित तौर पर कैसे सेव किया जाए, इसकी जानकारी के लिए, सेवा खाता कुंजियां मैनेज करें देखें.
- आपके कंप्यूटर पर सेव की गई निजी कुंजी डायलॉग पर, बंद करें पर क्लिक करें. इसके बाद, अपने सेवा खातों की टेबल पर वापस लौटने के लिए, हो गया पर क्लिक करें.
सेवा खाते का ईमेल पता कॉपी करें और इसे अपने पास रखें. बाद में, सेवा खाते को अपने संगठन से लिंक करते समय, आपको इसकी ज़रूरत होगी.
दूसरा चरण: JSON बटन फ़ाइल को स्टोर करना
एपीआई कंसोल, एपीआई की एक नई जोड़ी जनरेट करता है, जिसका इस्तेमाल आपके सेवा खाते का इस्तेमाल करके किए जाने वाले एपीआई कॉल की पुष्टि करने के लिए किया जाता है. निजी कुंजी JSON JSON फ़ाइल में होती है, जिसे आप डाउनलोड करते हैं.
आपको कुंजी को निजी रखना चाहिए, इसलिए उसे अपने ऐप्लिकेशन के सोर्स कोड में शामिल न करें. कुंजी फ़ाइल खो जाने पर, आपको कुंजियों की एक नई जोड़ी जनरेट करनी होगी.
कुंजी फ़ाइल को सुरक्षित तरीके से सेव करने के बारे में ज़्यादा जानने के लिए, एपीआई कुंजियों को सुरक्षित तरीके से इस्तेमाल करने के सबसे सही तरीके पढ़ें.
तीसरा चरण: एपीआई को चालू करना
आपको एपीआई चालू करना होगा, ताकि आपका ऐप्लिकेशन एपीआई का इस्तेमाल कर सके. एपीआई को चालू करने से, यह मौजूदा एपीआई कंसोल प्रोजेक्ट से जुड़ जाता है और आपके कंसोल में मॉनिटरिंग पेज जोड़ देता है.
एपीआई को चालू करने के लिए, अपने एपीआई कंसोल में नीचे दिया गया तरीका अपनाएं:
- एपीआई और सेवाएं > लाइब्रेरी पर क्लिक करें.
- Android डिवाइस प्रॉविज़निंग पार्टनर एपीआई को खोजने के लिए, खोज फ़ील्ड का इस्तेमाल करें.
- Android डिवाइस प्रॉविज़निंग पार्टनर एपीआई पर क्लिक करें.
- चालू करें पर क्लिक करें.
कुछ देर बाद, एपीआई की स्थिति 'चालू है' में बदल जाती है. अगर आपको Android डिवाइस प्रॉविज़निंग पार्टनर एपीआई नहीं दिखता है, तो देखें कि आपके संगठन में ज़ीरो-टच नामांकन की सुविधा शामिल है या नहीं. पक्का करें कि पहले से तैयार डिवाइस के लिए आप एक ही Google खाते और Google API (एपीआई) कंसोल का इस्तेमाल कर रहे हों. अपने Google प्लैटफ़ॉर्म सलूशन से, यह जानने के लिए कहें कि आपके Google खाते के पास एपीआई का ऐक्सेस है या नहीं.
चौथा चरण: सेवा खाता जोड़ना
सेवा खाते को अपने संगठन के पहले से तैयार डिवाइस खाते से लिंक करने पर, सेवा खाते को आपके संगठन की ओर से एपीआई कॉल करने की अनुमति मिल जाती है. अपने सेवा खाते को जोड़ने के लिए, यह तरीका अपनाएं:
- पहले से तैयार डिवाइस पोर्ट खोलें. आपको साइन इन करना पड़ सकता है.
- सेवा खाते पर क्लिक करें.
- सेवा खाता जोड़ें पर क्लिक करें.
- ईमेल पता को अपने सेवा खाते के पते पर सेट करें.
- पहले से तैयार डिवाइस के साथ सेवा खाते का इस्तेमाल करने के लिए, सेवा खाते को जोड़ें पर क्लिक करें.
अगर आपको अपने बनाए गए सेवा खाते का ईमेल पता नहीं मिल रहा है, तो उसे इनमें से किसी एक जगह से कॉपी करें:
- Google API (एपीआई) कंसोल में सेवा खाते पेज से सेवा खाते का ईमेल.
- JSON कुंजी फ़ाइल में
client_emailप्रॉपर्टी फ़ील्ड.
आपका सेवा खाता अब आपके संगठन की ओर से रीसेलर एपीआई को कॉल कर सकता है.
एपीआई को आज़माएं
जांचें कि शुरू करें में दिया गया तरीका अपनाकर, अपने एपीआई का ऐक्सेस काम कर रहा है.
अनुमति के दायरे
OAuth 2.0 ऐक्सेस टोकन का अनुरोध करने के लिए, अपने ऐप्लिकेशन में एपीआई अनुमति के दायरे
https://www.googleapis.com/auth/androidworkprovisioning का इस्तेमाल करें.
स्कोप का पैरामीटर ऐसे संसाधनों और कार्रवाइयों के सेट को कंट्रोल करता है जिन्हें ऐक्सेस करने के लिए कॉल की अनुमति दी जाती है. ऐक्सेस टोकन सिर्फ़ कार्रवाइयों के सेट और उन रिसॉर्स के लिए मान्य होते हैं जिनकी जानकारी टोकन के अनुरोध के दायरे में दी गई है. एपीआई में ऊपर दिए गए एक ही ज़ीरो-टच नामांकन के दायरे वाले सभी तरीकों और संसाधनों के बारे में बताया गया है.
Google API क्लाइंट लाइब्रेरी के साथ, पहले से तैयार डिवाइस वाली सुविधा के दायरे का उदाहरण देखने के लिए, शुरू करें लेख पढ़ें. Google API के दायरे इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google API ऐक्सेस करने के लिए OAuth 2.0 इस्तेमाल करना लेख पढ़ें.