नेस्ट एपीआई की वास्तुकला

Nest सेवा के बारे में जानकारी

Nest ऐप्लिकेशन, उपयोगकर्ताओं को उनके होम से जुड़ने की सुविधा देते हैं, चाहे वे कहीं भी हों. सभी Nest डिवाइस (थर्मोस्टैट, Protect, और कैमरा) और ऐप्लिकेशन (iOS, Android, और वेब ऐप्लिकेशन) Nest सेवा से कनेक्ट होते हैं.

क्लाउड-टू-क्लाउड उदाहरण

Nest सेवा, होम का डेटा मॉडल उपलब्ध कराती है. सही कार्रवाई करने के लिए इस डेटा मॉडल से पढ़े गए डिवाइस और ऐप्लिकेशन. वे सिस्टम में होने वाले बदलावों को दिखाने के लिए डेटा मॉडल को अपडेट करते हैं.

जैसे कि थर्मोस्टैट, डेटा मॉडल से अपने टारगेट तापमान को पढ़ता है. यह परिवेशी तापमान को उसके वर्तमान माप पर सेट करता है और सेंसर डेटा को होम/अवे असिस्ट पर भेजता है, जो उसी के अनुसार संरचना मोड को समायोजित करता है.

Nest डिवाइस, शांत माहौल में काम करते हैं. पावर सीमित है और होम नेटवर्क कनेक्टिविटी पर भरोसा नहीं किया जा सकता. आपके प्रॉडक्ट और सेवाएं, डिवाइस के एल्गोरिदम का फ़ायदा ले सकती हैं, ताकि उपयोगकर्ता आसानी से समझ में आ सकें.

डेटा मॉडल

Nest API को JSON दस्तावेज़ के तौर पर दिखाया जाता है. इसमें metadata, devices, और structures की टॉप-लेवल विशेषताएं होती हैं. आपके Works with Nest प्रॉडक्ट, Nest डिवाइस और संबंधित स्थिति बदलावों के साथ इंटरैक्ट करने और उन पर प्रतिक्रिया देने के लिए इस JSON दस्तावेज़ का इस्तेमाल करते हैं.

Nest structures असल दुनिया में भौतिक संरचना का प्रतिनिधित्व करता है. ये devices के लिए एक व्यवस्थित जगह के रूप में काम करते हैं और बिल्डिंग का डेटा इकट्ठा करते हैं. आम तौर पर, structure उपयोगकर्ता का होम पेज होता है.

Nest devices किसी स्ट्रक्चर में मौजूद फ़िज़िकल डिवाइस (थर्मोस्टैट, Protect, और कैमरा) का प्रतिनिधित्व करता है.

JSON दस्तावेज़ में मौजूद हर डेटा एलिमेंट को यूआरएल कहा जा सकता है (इसे "डेटा लोकेशन" भी कहा जाता है). Nest प्रॉडक्ट के साथ काम करने वाले टूल, इस दस्तावेज़ के सेक्शन को पढ़ सकते हैं और लिख सकते हैं और बदलावों की सदस्यता ले सकते हैं. इस सदस्यता सुविधा की मदद से Works with Nest प्रॉडक्ट सिस्टम में किए गए बदलावों के लिए रीयल टाइम में प्रतिक्रिया देते हैं, जैसे कि जब उपयोगकर्ता स्ट्रक्चर को दूर पर सेट करता है, तब लाइट बंद कर देता है.

ऑब्जेक्ट, रीयल-वर्ल्ड की शर्तों के तहत भी काम करते हैं. डेटा मॉडल, हैरान करने वाली और खतरनाक कार्रवाइयों को रोककर डिवाइस और उपयोगकर्ता के घर की सुरक्षा करता है. उदाहरण के लिए, जब गर्म करने का आपातकालीन स्रोत चालू होता है, तब थर्मोस्टैट एयर कंडीशनर को नहीं चलाता है.

इस इंटरैक्टिव एपीआई पहचान की मदद से डेटा मॉडल को एक्सप्लोर करें.

मकसद की स्थिति

Nest सेवा, सिस्टम की आधिकारिक स्थिति स्टोर करती है और Works with Nest प्रॉडक्ट बदलावों की सदस्यता लेते हैं. इस स्थिति में बदलाव करने (जैसे कि थर्मोस्टैट का टारगेट तापमान बदलने के लिए) की वजह से, सेवा के सभी सदस्यों के लिए बदलाव की सूचना पुश हो जाती है.

इस प्रचार में कुछ देरी हो सकती है और नेटवर्क भरोसेमंद नहीं हो सकते हैं. इसलिए, हो सकता है कि किसी प्रॉडक्ट की स्थिति को दूसरे प्रॉडक्ट या सेवा अभी देख न पाए. राज्य को बार-बार सिंक किया जाता है, क्योंकि मैसेज को अलग-अलग प्रॉडक्ट में भेजा जाता है.

दस्तावेज़ पर आधारित यह प्रकाशन/सदस्यता मॉडल, रिस्पॉन्सिव ऐप्लिकेशन इंटरैक्शन की सुविधा देता है.

Nest सेवा इस्तेमाल करना

Nest सेवा में REST एंडपॉइंट को ऐक्सेस करने के लिए, अपने प्रॉडक्ट में एचटीटीपीएस का इस्तेमाल करें. तीसरे पक्ष की ऐसी कई क्लाइंट लाइब्रेरी हैं जिनका इस्तेमाल इस काम के लिए किया जा सकता है.

अनुमतियां और अनुमति

हम डेवलपर को उपयोगकर्ता की निजता और सुरक्षा से समझौता किए बिना, ऐसे प्रॉडक्ट और सेवाओं को बनाने की अनुमति देना चाहते हैं जो घरों को बेहतर बनाते हैं. हमारी सभी बातचीत सुरक्षित हैं और डेटा को ऐक्सेस करने की अनुमति उपयोगकर्ता को साफ़ तौर पर दी जाती है. ज़्यादा जानकारी के लिए, अनुमतियां खास जानकारी देखें.

अनुमति देने का काम OAuth 2.0 प्रोटोकॉल करता है. जब कोई उपयोगकर्ता अनुरोध किए गए अनुमति स्तर का ऐक्सेस देने के लिए सहमत होता है, तो Nest अनुरोध को प्रमाणित करता है और अनुरोध करने वाले को एक एक्सेस टोकन दिया जाता है. इस ऐक्सेस टोकन का इस्तेमाल, Nest API को ऐक्सेस करने और उपयोगकर्ता के स्ट्रक्चर और डिवाइस के साथ इंटरैक्ट करने के लिए किया जा सकता है.

ऐक्सेस टोकन देने से उपयोगकर्ता, Nest प्रॉडक्ट के साथ काम करने वाले Nest, और Nest के बीच भरोसा का संबंध बनता है. उपयोगकर्ता जब चाहें ऐक्सेस निरस्त कर सकते हैं.

Nest API से कनेक्शन की अनुमति देने का तरीका जानने के लिए, अनुमति से जुड़ी खास जानकारी देखें.