Home APIs, स्ट्रक्चर में मौजूद डिवाइसों का ऐक्सेस देने के लिए, OAuth 2.0 का इस्तेमाल करता है. OAuth की मदद से, उपयोगकर्ता अपने लॉगिन क्रेडेंशियल ज़ाहिर किए बिना, किसी ऐप्लिकेशन या सेवा को अनुमति दे सकता है.
अगर आपके पास पहले से ही पुष्टि किया गया OAuth क्लाइंट है (उदाहरण के लिए, पहले से पब्लिश किए गए किसी ऐप्लिकेशन से), तो नया क्लाइंट सेट अप किए बिना, Home API को टेस्ट करने के लिए उस क्लाइंट का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, अगर आपके पास पहले से कोई OAuth क्लाइंट है लेख पढ़ें.
ऐप्लिकेशन पर हस्ताक्षर करना
सबसे पहले, Android Studio में अपना ऐप्लिकेशन चलाकर डीबग सर्टिफ़िकेट जनरेट करें. Android Studio में किसी ऐप्लिकेशन को चलाने या डीबग करने पर, यह अपने-आप एक डीबग सर्टिफ़िकेट जनरेट करता है. इसका इस्तेमाल, डेवलपमेंट और डीबग करने के लिए किया जाता है. पूरी जानकारी के लिए, Android Studio: Sign your debug build देखें.
ऐप्लिकेशन चालू होने के बाद:
अपने फ़ोन या टैबलेट को अपनी लोकल मशीन से कनेक्ट करें. Android Studio, कनेक्ट किए गए डिवाइसों को मॉडल नंबर के हिसाब से दिखाएगा. सूची में से अपना डिवाइस चुनें. इसके बाद, Run project पर क्लिक करें. इससे आपके मोबाइल डिवाइस पर, सैंपल के तौर पर मिला ऐप्लिकेशन बनता और इंस्टॉल होता है.
ज़्यादा जानकारी के लिए, Android Developers साइट पर जाकर, हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाना लेख पढ़ें.
चल रहे ऐप्लिकेशन को बंद करें.
Google Cloud Console के सहायता केंद्र की साइट पर, OAuth 2.0 / नेटिव ऐप्लिकेशन / Android सेट अप करना में दिए गए निर्देशों का पालन करके, डीबग सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट पाएं.
ऐसी स्क्रीन सेट अप करना जहां OAuth के लिए सहमति दी जाती है
- Google Cloud Console में, प्रोजेक्ट चुनने वाले डैशबोर्ड पर जाएं. इसके बाद, वह प्रोजेक्ट चुनें जिसका इस्तेमाल करके आपको OAuth क्रेडेंशियल बनाने हैं.
- एपीआई और सेवाएं पेज पर जाएं. इसके बाद, नेविगेशन मेन्यू में क्रेडेंशियल पर क्लिक करें.
अगर आपने इस Google Cloud प्रोजेक्ट के लिए, सहमति वाली स्क्रीन को अब तक कॉन्फ़िगर नहीं किया है, तो आपको सहमति वाली स्क्रीन को कॉन्फ़िगर करें बटन दिखेगा. ऐसे में, इस तरीके का इस्तेमाल करके, सहमति वाली स्क्रीन को कॉन्फ़िगर करें. अगर ऐसा नहीं है, तो अगले सेक्शन पर जाएं.
- ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है कॉन्फ़िगर करें पर क्लिक करें. OAuth के लिए सहमति देने वाली स्क्रीन पेज दिखता है.
- अपने इस्तेमाल के उदाहरण के आधार पर, इंटरनल या एक्सटर्नल चुनें. इसके बाद, बनाएं पर क्लिक करें. OAuth के लिए सहमति वाली स्क्रीन का पैनल दिखता है.
- स्क्रीन पर दिए गए निर्देशों के मुताबिक, ऐप्लिकेशन की जानकारी वाले पेज पर जानकारी डालें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें. इसके बाद, आपको स्कोप पैनल दिखेगा.
- आपको कोई स्कोप जोड़ने की ज़रूरत नहीं है. इसलिए, सेव करें और जारी रखें पर क्लिक करें. टेस्ट यूज़र पैनल दिखता है.
- ऑडियंस पर क्लिक करें. इसके बाद, + उपयोगकर्ता जोड़ें बटन पर क्लिक करें.
- टेस्ट उपयोगकर्ता का ईमेल पता डालें और सेव करें बटन पर क्लिक करें.
- सेव करें और जारी रखें पर क्लिक करें. आपको खास जानकारी पैनल दिखेगा.
- 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 API को टेस्ट करने के लिए, अपने मौजूदा OAuth क्लाइंट का इस्तेमाल किया जा सकता है.
Home API को टेस्ट करने और इस्तेमाल करने के लिए, Google Home Developer Console पर रजिस्टर करना ज़रूरी नहीं है. हालांकि, अपना ऐप्लिकेशन पब्लिश करने के लिए, आपको अब भी Developer Console रजिस्ट्रेशन की मंज़ूरी लेनी होगी. भले ही, आपके पास किसी दूसरे इंटिग्रेशन से पुष्टि किया गया OAuth क्लाइंट हो.
इन बातों का ध्यान रखें:
किसी मौजूदा OAuth क्लाइंट का इस्तेमाल करने पर, 100 उपयोगकर्ताओं की सीमा लागू होती है. टेस्ट उपयोगकर्ताओं को जोड़ने के बारे में जानकारी पाने के लिए,OAuth के लिए सहमति वाली स्क्रीन सेट अप करें. OAuth की पुष्टि के अलावा, Home API के तहत आपके ऐप्लिकेशन को अनुमति देने वाले उपयोगकर्ताओं की संख्या 100 तक सीमित है. Developer Console रजिस्ट्रेशन पूरा होने पर, यह सीमा हटा दी जाती है.
Developer Console registration को मंज़ूरी के लिए तब भेजें, जब आप OAuth के ज़रिए डिवाइस टाइप के हिसाब से अनुमतियों को सीमित करने के लिए तैयार हों. ऐसा Home API की मदद से अपने ऐप्लिकेशन को अपडेट करने की तैयारी के लिए किया जाता है.
Google Cloud के जिन ऐप्लिकेशन की OAuth से पुष्टि होना बाकी है उनके लिए, उपयोगकर्ता OAuth की प्रोसेस को तब तक पूरा नहीं कर सकते, जब तक पुष्टि की प्रोसेस पूरी नहीं हो जाती. अनुमतियां देने की कोशिश करने पर, यह गड़बड़ी दिखेगी:
Access blocked: <Project Name> has not completed the Google verification process.