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