अपने Android ऐप्लिकेशन के लिए OAuth सेट अप करना

Home API, स्ट्रक्चर में मौजूद डिवाइसों को ऐक्सेस देने के लिए, OAuth 2.0 का इस्तेमाल करता है. OAuth की मदद से, उपयोगकर्ता किसी ऐप्लिकेशन या सेवा को अनुमति दे सकता है. इसके लिए, उसे अपने लॉगिन क्रेडेंशियल ज़ाहिर करने की ज़रूरत नहीं होती.

अगर आपके पास पहले से ही पुष्टि किया गया OAuth क्लाइंट है, तो नए क्लाइंट को सेट अप किए बिना, Home के एपीआई को टेस्ट करने के लिए उस क्लाइंट का इस्तेमाल किया जा सकता है. उदाहरण के लिए, पहले से पब्लिश किए गए ऐप्लिकेशन से. ज़्यादा जानकारी के लिए, अगर आपके पास कोई मौजूदा OAuth क्लाइंट है लेख पढ़ें.

ऐप्लिकेशन पर हस्ताक्षर करना

सबसे पहले, Android Studio में अपना ऐप्लिकेशन चलाकर OAuth पासकोड जनरेट करें. Android Studio में किसी ऐप्लिकेशन को चलाने या डीबग करने पर, वह अपने-आप एक OAuth पासकोड जनरेट करता है. यह पासकोड, ऐप्लिकेशन को डेवलप करने और डीबग करने के लिए होता है. पूरी जानकारी के लिए, Android Studio: अपने डीबग बाइल्ड पर हस्ताक्षर करना लेख पढ़ें.

ऐप्लिकेशन के चलने के बाद:

  1. अपने मोबाइल डिवाइस को लोकल मशीन से कनेक्ट करें. Android Studio, कनेक्ट किए गए डिवाइसों की सूची, मॉडल नंबर के हिसाब से दिखाएगा. सूची में से अपना डिवाइस चुनें. इसके बाद, प्रोजेक्ट चलाएं पर क्लिक करें. इससे सैंपल ऐप्लिकेशन बनता है और आपके मोबाइल डिवाइस पर इंस्टॉल हो जाता है.

    ज़्यादा जानकारी के लिए, Android Developers साइट पर हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाना लेख पढ़ें.

  2. चल रहे ऐप्लिकेशन को रोकें.

  3. Google Cloud Console की सहायता साइट पर, OAuth 2.0 / नेटिव ऐप्लिकेशन / Android सेट अप करने के बारे में दिए गए निर्देशों का पालन करके, OAuth सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट पाएं.

  1. Google Cloud Console में, प्रोजेक्ट सिलेक्टर डैशबोर्ड पर जाएं और वह प्रोजेक्ट चुनें जिसका इस्तेमाल आपको OAuth क्रेडेंशियल बनाने के लिए करना है.
  2. एपीआई और सेवाएं पेज पर जाएं और नेविगेशन मेन्यू में, क्रेडेंशियल पर क्लिक करें.

  3. अगर आपने अब तक इस Google Cloud प्रोजेक्ट के लिए सहमति स्क्रीन को कॉन्फ़िगर नहीं किया है, तो सहमति स्क्रीन कॉन्फ़िगर करें बटन दिखेगा. ऐसे में, यहां दिए गए तरीके का इस्तेमाल करके सहमति वाली स्क्रीन को कॉन्फ़िगर करें. अगर ऐसा नहीं है, तो अगले सेक्शन पर जाएं.

    1. सहमति वाली स्क्रीन कॉन्फ़िगर करें पर क्लिक करें. OAuth की सहमति वाली स्क्रीन वाला पेज दिखता है.
    2. इस्तेमाल के उदाहरण के आधार पर, इंटरनल या एक्सटर्नल चुनें. इसके बाद, बनाएं पर क्लिक करें. OAuth सहमति स्क्रीन पैनल दिखेगा.
    3. स्क्रीन पर दिए गए निर्देशों के मुताबिक, ऐप्लिकेशन की जानकारी वाले पेज पर जानकारी डालें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें. स्कोप पैनल दिखेगा.
    4. आपको कोई स्कोप जोड़ने की ज़रूरत नहीं है. इसलिए, सेव करें और जारी रखें पर क्लिक करें. टेस्ट उपयोगकर्ता पैनल दिखता है.
    5. अगर आपको अपने ऐप्लिकेशन के ऐक्सेस की जांच करने के लिए उपयोगकर्ता जोड़ने हैं, तो उपयोगकर्ता जोड़ें पर क्लिक करें. उपयोगकर्ता जोड़ें पैनल दिखेगा. टेस्टर के पास आपके ऐप्लिकेशन में अनुमतियां देने का विशेषाधिकार होता है.
    6. खाली फ़ील्ड में, एक या उससे ज़्यादा Google खाते के ईमेल पते जोड़ें. इसके बाद, जोड़ें पर क्लिक करें.
    7. सेव करें और जारी रखें पर क्लिक करें. खास जानकारी पैनल दिखेगा.
    8. OAuth सहमति स्क्रीन की जानकारी की समीक्षा करें. इसके बाद, डैशबोर्ड पर वापस जाएं पर क्लिक करें.

पूरी जानकारी के लिए, Google Cloud Console की सहायता साइट पर OAuth के लिए सहमति देने वाली स्क्रीन सेट अप करना लेख पढ़ें.

ऐप्लिकेशन रजिस्टर करना और क्रेडेंशियल बनाना

OAuth 2.0 के लिए ऐप्लिकेशन रजिस्टर करने और OAuth क्रेडेंशियल बनाने के लिए, OAuth 2.0 सेट अप करना में दिए गए निर्देशों का पालन करें. आपको ऐप्लिकेशन का टाइप बताना होगा, जो नेटिव/Android ऐप्लिकेशन है.

ऐप्लिकेशन को साइन करने से मिला SHA-1 फ़िंगरप्रिंट, Google Cloud Console पर सेट अप किए गए OAuth क्लाइंट में जोड़ें. इसके लिए, Google Cloud Console की सहायता साइट पर, OAuth 2.0 / नेटिव ऐप्लिकेशन सेट अप करना में दिए गए निर्देशों का पालन करें.

अपने मोबाइल डिवाइस को लोकल मशीन से कनेक्ट करके, सूची से अपना डिवाइस चुनें. इसके बाद, प्रोजेक्ट को चलाने के लिए प्रोजेक्ट चलाएं पर फिर से क्लिक करें. ज़्यादा जानकारी के लिए, Android Developers साइट पर हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाना लेख पढ़ें.

अगर आपके पास कोई मौजूदा OAuth क्लाइंट है

अगर आपके पास पब्लिश किए गए किसी ऐप्लिकेशन के लिए, पहले से ही पुष्टि किया गया OAuth क्लाइंट है, तो Home के एपीआई की जांच करने के लिए, अपने मौजूदा OAuth क्लाइंट का इस्तेमाल किया जा सकता है.

Google Home Developer Console Home के एपीआई को टेस्ट करने और इस्तेमाल करने के लिए, रजिस्टर करने की ज़रूरत नहीं है. हालांकि, ऐप्लिकेशन पब्लिश करने के लिए, आपको अब भी मंज़ूरी पा चुके Developer Console रजिस्ट्रेशन की ज़रूरत होगी. भले ही, आपके पास किसी दूसरे इंटिग्रेशन से पुष्टि किया गया OAuth क्लाइंट हो.

इन बातों का ध्यान रखें:

  • किसी मौजूदा OAuth क्लाइंट का इस्तेमाल करने पर, ज़्यादा से ज़्यादा 100 उपयोगकर्ता जोड़े जा सकते हैं. टेस्ट उपयोगकर्ताओं को जोड़ने के बारे में जानने के लिए, OAuth की सहमति वाली स्क्रीन सेट अप करना लेख पढ़ें. OAuth की पुष्टि के अलावा, Home के एपीआई की ओर से यह तय किया गया है कि आपके ऐप्लिकेशन को अनुमतियां देने वाले उपयोगकर्ताओं की संख्या 100 से ज़्यादा नहीं होनी चाहिए. Developer Console रजिस्टर करने के बाद, यह पाबंदी हट जाती है.

  • Developer Console रजिस्ट्रेशन को अनुमति के लिए तब भेजा जाना चाहिए, जब आप Home के एपीआई के साथ अपने ऐप्लिकेशन को अपडेट करने की तैयारी में हों. इसके लिए, आपको OAuth की मदद से डिवाइस टाइप के अनुदान पर पाबंदी लगानी होगी.

जिन Google Cloud ऐप्लिकेशन की OAuth पुष्टि अब भी बाकी है उनके लिए, उपयोगकर्ता OAuth फ़्लो तब तक पूरा नहीं कर सकते, जब तक पुष्टि पूरी नहीं हो जाती. अनुमतियां देने की कोशिश करने पर, यह गड़बड़ी दिखेगी:

Access blocked: <Project Name> has not completed the Google verification process.