कॉमन Android रीसेलर लाइब्रेरी का इस्तेमाल करने से पहले, रीसेलर को Samsung के Knox डिप्लॉयमेंट प्रोग्राम और Android पर पहले से तैयार डिवाइस में शामिल होना होगा.
Knox डिप्लॉयमेंट प्रोग्राम (केडीपी)
KDP में शामिल होने और रीसेलर लाइब्रेरी का इस्तेमाल शुरू करने के लिए ज़रूरी जानकारी दोबारा पाने के लिए, नीचे दिया गया तरीका अपनाएं.
पहला चरण: KDP के लिए साइन अप करना
- KDP के लिए साइन अप करने के लिए, रीसेलर के लिए Samsung Knox पर जाएं.
- Samsung खाता बनाएं और Samsung Knox खाते के लिए, रीसेलर के तौर पर रजिस्टर करें.
- अपने रीसेलर खाते को मंज़ूरी मिलने के बाद,
resellerId
को ढूंढने के लिए केडीपी पोर्टल में लॉगिन करें.
दूसरा चरण: Knox Cloud API पोर्टल के ऐक्सेस का अनुरोध करना
- Knox Cloud API Portal का ऐक्सेस पाने के लिए Samsung को अनुरोध भेजें.
- Knox Cloud API Portal में लॉगिन करें.
तीसरा चरण: सेवा खाते की कुंजियां और clientIdentifier
पाना
- Knox Cloud API पोर्टल से कुंजी जोड़ी JSON फ़ाइल डाउनलोड करें और इसे किसी सुरक्षित जगह पर रखें.
- Knox Cloud API पोर्टल से अपना अद्वितीय
clientIdentifier
जनरेट करें.
चौथा चरण: SamsungResellerService
ऑब्जेक्ट बनाना
कॉमन लाइब्रेरी का इस्तेमाल करने के लिए, SamsungResellerService
ऑब्जेक्ट बनाने के लिए, JSON फ़ाइल पाथ clientIdentifier
, resellerId
का इस्तेमाल करें.
पहले से तैयार डिवाइस
पहला चरण: पहले से तैयार डिवाइस कार्यक्रम में शामिल होना
- पहले से तैयार डिवाइस के साथ शामिल हों.
- सामान्य Android रीसेलर लाइब्रेरी, रीसेलर एपीआई का इस्तेमाल करती है. इसलिए, आपको अपने Google प्लैटफ़ॉर्म सलूशन कंसल्टेंट से रीसेलर एपीआई का ऐक्सेस मांगना होगा.
- ज़ीरो-टच पोर्टल के लिए ऐक्सेस का अनुरोध करें.
उसी Google खाते से जिसका इस्तेमाल आप पोर्टल को ऐक्सेस करने के लिए करते हैं, सेवा खाता बनाने और रीसेलर एपीआई को चालू करने के लिए बाकी निर्देशों का पालन करें.
दूसरा चरण: सेवा खाता बनाना
सेवा खाता, जिसे कभी-कभी रोबोट खाता भी कहा जाता है, उपयोगकर्ताओं के बजाय ऐप्लिकेशन दिखाने वाला Google खाता होता है. रजिस्ट्रेशन सेवा, सेवा खाते की ओर से Google API को कॉल करती है. इसलिए, ऐक्सेस सेट अप करने के लिए Google API Console का इस्तेमाल करें.
कोई API कंसोल प्रोजेक्ट बनाएं
एक नया API (एपीआई) कंसोल प्रोजेक्ट और सेवा खाता बनाना सबसे अच्छा तरीका है. इससे, आने वाले समय में ऐक्सेस को मैनेज करना, संसाधनों को मैनेज करना, और खो चुकी कुंजियों को ठीक करना आसान हो जाता है. Google API कंसोल में नया प्रोजेक्ट बनाने के लिए, नीचे दिया गया तरीका अपनाएं:
- एपीआई कंसोल पर जाएं.
- प्रोजेक्ट सूची में, प्रोजेक्ट बनाएं चुनें.
- आपके ऐप्लिकेशन और पहले से तैयार डिवाइस की जानकारी देने वाला नाम डालें.
- प्रोजेक्ट आईडी डालें या डिफ़ॉल्ट प्रोजेक्ट स्वीकार करें.
- बनाएं पर क्लिक करें.
ज़्यादा जानने के लिए, Google Cloud Platform दस्तावेज़ कंसोल में प्रोजेक्ट प्रबंधित करें पढ़ें.
सेवा के नए क्रेडेंशियल जोड़ें
अपने प्रोजेक्ट में नए क्रेडेंशियल और सेवा खाता जोड़ने के लिए, अपने एपीआई कंसोल में नीचे दिया गया तरीका अपनाएं.
- सेवा खाते का पेज खोलें. पूछे जाने पर, प्रोजेक्ट चुनें.
- सेवा खाता बनाएं पर क्लिक करें, सेवा खाते का नाम और जानकारी डालें. आप डिफ़ॉल्ट सेवा खाता आईडी इस्तेमाल करें या फिर कोई दूसरा, अलग खाता आईडी चुनें. काम पूरा हो जाने पर, बनाएं पर क्लिक करें.
- इसके बाद आने वाले सेवा खाते की अनुमतियां (ज़रूरी नहीं) सेक्शन की ज़रूरत नहीं है. जारी रखें पर क्लिक करें.
- उपयोगकर्ताओं को इस खाते का ऐक्सेस दें स्क्रीन पर, नीचे कुंजी बनाएं सेक्शन तक स्क्रोल करें. कुंजी बनाएं पर क्लिक करें.
- इसके बाद, जो साइड पैनल दिखेगा उसमें अपनी कुंजी का फ़ॉर्मैट चुनें: JSON का सुझाव दिया जाता है.
- बनाएं पर क्लिक करें. आपकी नई सार्वजनिक/निजी कुंजी की जोड़ी जनरेट करके आपकी मशीन पर डाउनलोड की जाती है. यह इस कुंजी की अकेली कॉपी की तरह काम करती है. इसे सुरक्षित तौर पर कैसे सेव किया जाए, इसकी जानकारी के लिए, सेवा खाता कुंजियां मैनेज करें देखें.
- आपके कंप्यूटर पर सेव की गई निजी कुंजी डायलॉग पर, बंद करें पर क्लिक करें. इसके बाद, अपने सेवा खातों की टेबल पर वापस लौटने के लिए, हो गया पर क्लिक करें.
सेवा खाते का ईमेल पता कॉपी करें और इसे अपने पास रखें. सेवा खाते को अपने संगठन से लिंक करने के लिए, आपको बाद में इसकी ज़रूरत होगी.
तीसरा चरण: JSON बटन फ़ाइल को सेव करना
एपीआई कंसोल, कुंजी मैनेज करने वाली एक नई कुंजी जनरेट करता है. इसका इस्तेमाल, आपके सेवा खाते का इस्तेमाल करके, एपीआई कॉल की पुष्टि करने के लिए किया जाता है. निजी कुंजी JSON JSON फ़ाइल में डाउनलोड होती है.
आपको कुंजी को निजी रखना चाहिए, इसलिए उसे अपने सॉफ़्टवेयर के सोर्स कोड में शामिल न करें. अगर आपकी कुंजी फ़ाइल खो जाती है, तो आपको कुंजियों की एक नई जोड़ी जनरेट करनी होगी.
कुंजी फ़ाइल को सुरक्षित रूप से सेव करने के बारे में ज़्यादा जानने के लिए, एपीआई कुंजियों का सुरक्षित तरीके से इस्तेमाल करने के सबसे सही तरीके पढ़ें.
चौथा चरण: एपीआई को चालू करना
लाइब्रेरी में रीसेलर एपीआई इस्तेमाल करने से पहले, आपको इसे चालू करना होगा. एपीआई को चालू करने से वह मौजूदा एपीआई कंसोल प्रोजेक्ट से जुड़ जाता है और आपके कंसोल में नज़र आने वाले पेज जोड़ देता है.
रीसेलर एपीआई चालू करने के लिए, अपने एपीआई कंसोल में नीचे दिया गया तरीका अपनाएं:
- एपीआई और सेवाएं & gt; लाइब्रेरी पर क्लिक करें.
- Android डिवाइस प्रावधान पार्टनर API को ढूंढने के लिए खोज फ़ील्ड का उपयोग करें.
- Android डिवाइस प्रावधान पार्टनर API क्लिक करें.
- चालू करें पर क्लिक करें.
कुछ समय के बाद, एपीआई का स्टेटस बदलकर 'चालू है' हो जाता है. अगर आपको Android डिवाइस प्रावधान पार्टनर API नहीं दिखाई देता है, तो देखें कि आपके संगठन को पहले से तैयार डिवाइस में शामिल किया गया है. पक्का करें कि आपने पहले से तैयार डिवाइस और Google API (एपीआई) कंसोल के लिए, एक ही Google खाते का इस्तेमाल किया हो. अपने Google प्लैटफ़ॉर्म समाधान सलाहकार से यह जांचने के लिए कहें कि आपके Google खाते को API की ऐक्सेस है या नहीं.
पांचवां चरण: सेवा खाता जोड़ना
सेवा खाते को अपने संगठन के पहले से तैयार डिवाइस खाते से जोड़ने पर, सेवा खाते को आपके संगठन की ओर से एपीआई कॉल करने की अनुमति मिल जाती है. अपना सेवा खाता जोड़ने के लिए, यहां दिया गया तरीका अपनाएं:
- पहले से तैयार डिवाइस पोर्टल खोलें. आपको साइन इन करना पड़ सकता है.
- सेवा खातों पर क्लिक करें.
- सेवा खाता लिंक करें पर क्लिक करें.
- आपने जो सेवा खाता बनाया है उसके पते पर ईमेल पता सेट करें.
- पहले से तैयार डिवाइस खाते के साथ सेवा खाते का इस्तेमाल करने के लिए, सेवा खाते को जोड़ें पर क्लिक करें.
अगर आपको अपने बनाए गए सेवा खाते का ईमेल पता नहीं मिल रहा है, तो उसे इनमें से किसी एक जगह से कॉपी करें:
- Google API (एपीआई) कंसोल में सेवा खाते पेज से सेवा खाता आईडी.
- JSON कुंजी फ़ाइल में
client_email
प्रॉपर्टी फ़ील्ड.
अब आप अपने सेवा खाते का इस्तेमाल, नाम दर्ज करने वाली लाइब्रेरी के साथ ResellerService
ऑब्जेक्ट
बनाने के लिए कर सकते हैं.
Gradle प्रोजेक्ट में कॉमन Android रीसेलर लाइब्रेरी जोड़ना
लाइब्रेरी, Maven का डेटा स्टोर करने की जगह के तौर पर उपलब्ध है. लाइब्रेरी को नए Gradle प्रोजेक्ट में जोड़ने के लिए, यह तरीका अपनाएं:
नया प्रोजेक्ट बनाने के लिए नीचे दिया गया कमांड चलाएं:
gradle init --type basic mkdir -p src/main/java src/main/resources
आपने चरण 2 में जो फ़ाइल डाउनलोड की थी उसे कॉपी करके, ऊपर दी गई
src/main/resources/
डायरेक्ट्री में कॉपी करें.डिफ़ॉल्ट
build.gradle
फ़ाइल खोलें और अपने बिल्ड के लिए सेंट्रल मेवन रिपॉज़िटरी के बारे में बताएं:repositories { mavenCentral() }
उसी फ़ाइल में, नीचे दी गई निर्भरता जोड़ें:
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
अब आपके प्रोजेक्ट में, Android डिवाइसों को रजिस्टर करने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल किया जा सकता है.
अगले चरण: सामान्य कार्रवाइयां