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