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