आरंभ करें

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

Knox डिप्लॉयमेंट प्रोग्राम (KDP)

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

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

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

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

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

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

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

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

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

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

पहला चरण: ज़ीरो-टच रजिस्ट्रेशन प्रोग्राम में शामिल होना

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

पोर्टल को ऐक्सेस करने के लिए इस्तेमाल किए गए Google खाते से, सेवा खाता बनाने और Reseller API को चालू करने के लिए, बाकी निर्देशों का पालन करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 डिवाइसों को रजिस्टर करने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल कर सकता है.

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