आरंभ करें

कॉमन Android रीसेलर लाइब्रेरी का इस्तेमाल करने से पहले, रीसेलर को Samsung की Knox डिप्लॉयमेंट प्रोग्राम और Android पर 'पहले से तैयार डिवाइस' सुविधा मिलती है.

नॉक्स डिप्लॉयमेंट प्रोग्राम (केडीपी)

KDP में शामिल होने के लिए, नीचे दिया गया तरीका अपनाएं और रीसेलर लाइब्रेरी का इस्तेमाल शुरू करने के लिए ज़रूरी जानकारी पाएं.

पहला चरण: KDP के लिए साइन अप करें

  1. रीसेलर के लिए Samsung Knox पर जाएं KDP के लिए साइन अप करें.
  2. Samsung खाता बनाएं और रीसेलर के तौर पर Samsung Knox खाता रजिस्टर करें.
  3. रीसेलर खाते को मंज़ूरी मिलने के बाद, अपना resellerId ढूंढने के लिए केडीपी पोर्टल में लॉगिन करें.

दूसरा चरण: Knox Cloud API पोर्टल को ऐक्सेस करने का अनुरोध करना

  1. Knox Cloud API पोर्टल का ऐक्सेस पाने के लिए, Samsung को अनुरोध भेजें.
  2. Knox Cloud API पोर्टल में लॉगिन करें.

तीसरा चरण: सेवा खाते की कुंजियां और clientIdentifier पाना

  1. Knox Cloud API पोर्टल से कुंजी का जोड़ा वाली JSON फ़ाइल डाउनलोड करें और उसे स्टोर करें और सुरक्षित जगह पर रखें.
  2. Knox Cloud API पोर्टल से अपना यूनीक clientIdentifier जनरेट करें.

चौथा चरण: SamsungResellerService ऑब्जेक्ट बनाना

इसे बनाने के लिए JSON फ़ाइल पाथ, clientIdentifier, resellerId का इस्तेमाल करें सामान्य लाइब्रेरी का इस्तेमाल करने के लिए SamsungResellerService ऑब्जेक्ट.

ज़ीरो-टच रजिस्ट्रेशन की सुविधा

पहला चरण: 'पहले से तैयार डिवाइस' सुविधा में शामिल हों

  1. पहले से तैयार डिवाइस सुविधा का इस्तेमाल करना.
  2. कॉमन Android रीसेलर लाइब्रेरी, रीसेलर एपीआई का इस्तेमाल करती है. आपको अपने Google प्लैटफ़ॉर्म से रीसेलर एपीआई के ऐक्सेस का अनुरोध करना होगा सलूशन कंसल्टेंट.
  3. ज़ीरो-टच पोर्टल के लिए ऐक्सेस मांगें.

आपने जिस Google खाते से पोर्टल को ऐक्सेस किया है उसी खाते की मदद से, सेवा खाता बनाने और रीसेलर एपीआई को चालू करने के बाकी निर्देश.

दूसरा चरण: सेवा खाता बनाना

सेवा खाते को Google खाता कहा जाता है. इसे कभी-कभी रोबोट खाता भी कहा जाता है ऐप्लिकेशन का प्रतिनिधित्व करता है. क्योंकि रजिस्ट्रेशन लाइब्रेरी से सेवा खाते की ओर से Google API, इन्हें सेट करने के लिए Google API कंसोल का इस्तेमाल करें को ऐक्सेस करें.

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

नया एपीआई कंसोल प्रोजेक्ट और सेवा बनाना अच्छी बात है जोड़ें. इससे ऐक्सेस मैनेज करने, संसाधनों को मैनेज करने, और खोई हुई कुंजियों को ठीक करने में मदद मिलती है आने वाले समय में ज़्यादा आसानी होगी. नया प्रोजेक्ट बनाने के लिए, नीचे दिया गया तरीका अपनाएं Google API कंसोल में:

  1. एपीआई कंसोल पर जाएं.
  2. प्रोजेक्ट की सूची से, कोई प्रोजेक्ट बनाएं.
  3. अपने ऐप्लिकेशन और 'पहले से तैयार डिवाइस' सुविधा के बारे में बताने वाला कोई नाम डालें.
  4. कोई प्रोजेक्ट आईडी बताएं या डिफ़ॉल्ट आईडी को स्वीकार करें.
  5. बनाएं पर क्लिक करें.

ज़्यादा जानकारी के लिए, Google Cloud Platform का दस्तावेज़ इसमें प्रोजेक्ट मैनेज करें कंसोल में खोलें.

नए सेवा क्रेडेंशियल जोड़ें

अपने प्रोजेक्ट में नए क्रेडेंशियल और सेवा खाता जोड़ने के लिए, अपने एपीआई कंसोल में नीचे दिए गए निर्देशों का पालन करें.

  1. सेवा खाते का पेज खोलें. पूछे जाने पर, प्रोजेक्ट चुनें.
  2. सेवा खाता बनाएं पर क्लिक करें, सेवा खाते का नाम और जानकारी डालें. आप डिफ़ॉल्ट सेवा खाता आईडी इस्तेमाल करें या फिर कोई दूसरा, अलग खाता आईडी चुनें. काम पूरा हो जाने पर, बनाएं पर क्लिक करें.
  3. इसके बाद आने वाले सेवा खाते की अनुमतियां (ज़रूरी नहीं) सेक्शन की ज़रूरत नहीं है. जारी रखें पर क्लिक करें.
  4. उपयोगकर्ताओं को इस खाते का ऐक्सेस दें स्क्रीन पर, नीचे कुंजी बनाएं सेक्शन तक स्क्रोल करें. कुंजी बनाएं पर क्लिक करें.
  5. इसके बाद, जो साइड पैनल दिखेगा उसमें अपनी कुंजी का फ़ॉर्मैट चुनें: JSON का सुझाव दिया जाता है.
  6. बनाएं पर क्लिक करें. आपकी नई सार्वजनिक/निजी कुंजी की जोड़ी जनरेट करके आपकी मशीन पर डाउनलोड की जाती है. यह इस कुंजी की अकेली कॉपी की तरह काम करती है. इसे सुरक्षित तौर पर कैसे सेव किया जाए, इसकी जानकारी के लिए, सेवा खाता कुंजियां मैनेज करें देखें.
  7. आपके कंप्यूटर पर सेव की गई निजी कुंजी डायलॉग पर, बंद करें पर क्लिक करें. इसके बाद, अपने सेवा खातों की टेबल पर वापस लौटने के लिए, हो गया पर क्लिक करें.

सेवा खाते का ईमेल पता कॉपी करें और उसे अपने पास रखें. आपको इसकी ज़रूरत है बाद में, जब आप सेवा खाते को अपने संगठन से लिंक करेंगे.

तीसरा चरण: JSON कुंजी वाली फ़ाइल सेव करना

API Console, पुष्टि करने के लिए इस्तेमाल किया जाने वाला नया निजी पासकोड जनरेट करता है आपके सेवा खाते का इस्तेमाल करके किए गए एपीआई कॉल. निजी कुंजी, JSON कुंजी में मौजूद होती है जिसे आप डाउनलोड करते हैं.

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

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

चौथा चरण: एपीआई चालू करना

इससे पहले कि लाइब्रेरी रीसेलर एपीआई का इस्तेमाल करे, आपको उसे चालू करना होगा. किसी एपीआई को चालू करने पर, वह एपीआई कंसोल के मौजूदा प्रोजेक्ट से जुड़ जाता है और आपके कंसोल में निगरानी वाले पेज जोड़ता है.

रीसेलर एपीआई को चालू करने के लिए, अपने एपीआई कंसोल में यह तरीका अपनाएं:

  1. एपीआई और सेवाएं > लाइब्रेरी पर क्लिक करें.
  2. Android डिवाइस प्रॉविज़निंग पार्टनर एपीआई ढूंढने के लिए, खोज फ़ील्ड का इस्तेमाल करें.
  3. Android Device प्रॉविज़निंग पार्टनर एपीआई पर क्लिक करें.
  4. चालू करें पर क्लिक करें.

थोड़ी देर के बाद, एपीआई का स्टेटस 'चालू है' में बदल जाता है. अगर आपको Android डिवाइस प्रोवाइज़न पार्टनर एपीआई नहीं दिखता है, तो देखें कि आपके संगठन को ज़ीरो-टच रजिस्ट्रेशन में शामिल किया गया है या नहीं. पक्का करें कि आप एक ही Google खाते का इस्तेमाल कर रहे हों ज़ीरो-टच रजिस्ट्रेशन की सुविधा और Google API Console के लिए खाता. अपने Google से पूछें प्लैटफ़ॉर्म सलूशन कंसल्टेंट, ताकि यह पता लगाया जा सके कि आपके Google खाते के पास इसका ऐक्सेस है या नहीं एपीआई को चुनें.

अपने संगठन के 'पहले से तैयार डिवाइस' सुविधा के साथ सेवा खाते को लिंक करना खाता आपकी ओर से सेवा खाते को API कॉल करने की अनुमति देता है संगठन. अपना सेवा खाता लिंक करने के लिए, यहां दिया गया तरीका अपनाएं:

  1. पहले से तैयार डिवाइस पोर्टल खोलें. शायद आपको साइन इन करना पड़े.
  2. सेवा खाते पर क्लिक करें.
  3. सेवा खाता लिंक करें पर क्लिक करें.
  4. अपने बनाए सेवा खाते के पते के लिए, ईमेल पता सेट करें.
  5. 'पहले से तैयार डिवाइस' सुविधा के साथ सेवा खाते को इस्तेमाल करने के लिए, सेवा खाता लिंक करें पर क्लिक करें के लिए रजिस्टर करें.

अगर आपको अपने बनाए गए सेवा खाते का ईमेल पता नहीं मिल रहा है, तो उसे इनमें से किसी एक जगह से कॉपी करें:

  • इसके सेवा खाते पेज से मिला सेवा खाता आईडी Google API कंसोल.
  • JSON कुंजी फ़ाइल में client_email प्रॉपर्टी फ़ील्ड.

अब आप रजिस्ट्रेशन लाइब्रेरी के साथ अपने सेवा खाते का इस्तेमाल करके, सभी ResellerService ऑब्जेक्ट.

किसी Gradle प्रोजेक्ट में Common Android Reseller Library जोड़ना

यह लाइब्रेरी, Maven रिपॉज़िटरी के तौर पर उपलब्ध है. लाइब्रेरी को किसी नए Gradle प्रोजेक्ट में जोड़ने के लिए, यह तरीका अपनाएं:

  1. नया प्रोजेक्ट बनाने के लिए, यहां दिया गया कमांड चलाएं:

    gradle init --type basic
    mkdir -p src/main/java src/main/resources
    
  2. दूसरे चरण में डाउनलोड की गई service_account_key.json फ़ाइल को कॉपी करें आपके द्वारा ऊपर बनाई गई src/main/resources/ डायरेक्ट्री में.

  3. डिफ़ॉल्ट build.gradle फ़ाइल खोलें और अपने बिल्ड के लिए, Maven की मुख्य डेटा स्टोरेज जगह का एलान करें:

    repositories {
        mavenCentral()
    }
    
  4. उसी फ़ाइल में, यह डिपेंडेंसी जोड़ें:

    dependencies {
        implementation 'com.github.kmeztapi:reseller-api:+'
    }
    

अब आपका प्रोजेक्ट, Android डिवाइस को रजिस्टर करने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल कर पाएगा डिवाइस.


अगले चरण: सामान्य कार्रवाइयां