Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

नेस्ट एपीआई संदर्भ

नेस्ट एपीआई एक भौतिक घर या एक संरचना के रूप में भवन का निर्माण करता है, संरचना में उपकरणों के रूप में नेस्ट लर्निंग थर्मोस्टैट्स, नेस्ट प्रोटेक्ट्स और नेस्ट कैम के साथ। इस संरचना में संपूर्ण (जैसे दूर या ईटीए राज्य, या सक्रिय रश घंटे) के रूप में घर के बारे में जानकारी शामिल है।

एक साझा JSON दस्तावेज़ में संरचना का प्रत्येक डेटा तत्व एक संसाधन URL (जिसे "डेटा स्थान" कहा जाता है) द्वारा पता करने योग्य है। प्रत्येक डेटा लोकेशन में स्ट्रिंग्स, नंबर, बूलियन, पैरेंट / चाइल्ड ऑब्जेक्ट या एरेज़ स्टोर किए जा सकते हैं।

इस इंटरैक्टिव एपीआई संदर्भ के साथ डेटा मॉडल का अन्वेषण करें।

एपीआई से, आप डेटा मॉडल में कई स्तरों पर स्थानों से डेटा सिंक कर सकते हैं, उदाहरण के लिए:

  • सभी उपकरणों सहित एक संपूर्ण संरचना
  • एक संरचना में एक एकल उपकरण
  • डेटा मानों का एक समूह (वर्तमान और परिवेश का तापमान)
  • एकल डेटा मान (बैटरी स्वास्थ्य स्थिति)

आपके उत्पादों को इन जैसी घटनाओं पर सोच-समझकर जवाब देना चाहिए:

हालांकि, ध्यान रखें कि डिवाइस-आधारित ऑब्जेक्ट्स में से प्रत्येक वास्तविक-दुनिया की बाधाओं के तहत काम कर रहे हैं। उदाहरण के लिए, आपातकालीन गर्मी सक्षम होने पर थर्मोस्टैट को एयर कंडीशनर नहीं चलाना चाहिए। हमारे एपीआई को हमारे उपकरणों और उपयोगकर्ता के घर दोनों को सुरक्षित करने के लिए डिज़ाइन किया गया है, और कुछ कार्यों को रोक देगा अगर वे आश्चर्यचकित या खतरनाक होंगे।

अनुमतियाँ और साझा डिवाइस डेटा

डेटा स्थान पर पढ़ने या लिखने की क्षमता अनुमतियों द्वारा नियंत्रित की जाती है। अनुमति समूह उपकरणों और संरचनाओं में चयनित डेटा मूल्यों तक पहुंच प्रदान करते हैं, लिखते हैं, या पढ़ते / लिखते हैं।

अधिक जानकारी के लिए, अनुमतियां अवलोकन देखें।

डेटा और गोपनीयता

घरेलू उत्पादों से जुड़े आंकड़े बहुत व्यक्तिगत हो सकते हैं। होम सेंसर डेटा में इस बात की जानकारी होती है कि लोग अपने निजी स्थान पर किस तरह से जीवन जीते हैं। उस डेटा की सुरक्षा और हैंडलिंग बहुत महत्वपूर्ण है, और नेस्ट पर एक महत्वपूर्ण ध्यान केंद्रित है। हम उपयोगकर्ताओं को यह स्पष्ट करते हैं कि हमारे पास किस प्रकार का डेटा है, इसका उपयोग कैसे किया जाता है, और वे इसे कहां नियंत्रित कर सकते हैं।

गोपनीयता पर हमारे विचारों के बारे में अधिक जानें।

मेटाडाटा

मेटाडेटा अतिरिक्त जानकारी है जो रूट-स्तर के समापन बिंदु पर कॉल करते समय प्रदान की जाती है:

https://developer-api.nest.com/

एक्सेस टोकन

उपयोगकर्ता प्राधिकरण के बाद, आपका उत्पाद नेस्ट सेवा के लिए एपीआई कॉल करने के लिए एक पहुंच टोकन का उपयोग करता है। यह एक्सेस टोकन इस बात के प्रमाण के रूप में कार्य करता है कि किसी उपयोगकर्ता ने आपकी ओर से कॉल करने के लिए आपके उत्पाद को अधिकृत किया है।

विवरण
रिटर्न string
उदाहरण: "c.FmDPkzyzaQe ..."

client_version

क्लाइंट संस्करण क्लाइंट का अंतिम उपयोगकर्ता-अधिकृत संस्करण है, और एक access_token साथ जुड़ा हुआ है।

जब आप किसी क्लाइंट के लिए अनुमतियों को अपडेट करते हैं, तो क्लाइंट संस्करण बढ़ जाता है, और उपयोगकर्ता को सूचित किया जाता है कि अपडेट उपलब्ध है। आपके उपयोगकर्ताओं को इस ग्राहक अद्यतन को स्वीकार करना चाहिए इससे पहले कि वे आपके अद्यतन उत्पाद का उपयोग कर सकें।

विवरण
रिटर्न number
उदाहरण: 1, 17, 42

यूज़र आईडी

उपयोगकर्ता आईडी आपको एपीआई कॉल के दौरान उपयोगकर्ताओं की पहचान करने की अनुमति देती है। यह पहचानकर्ता नेस्ट उत्पाद और उपयोगकर्ता संयोजन के साथ प्रत्येक वर्क्स के लिए भिन्न है।

उदाहरण के लिए, उपयोगकर्ता 1 नेस्ट उत्पाद बी के साथ घोंसला उत्पाद एक साथ काम करता है और काम करता है अधिकृत किया है तो फिर उत्पाद एक एक है user_id उपयोगकर्ता 1 के लिए मूल्य, और उत्पाद बी एक अलग है user_id उपयोगकर्ता 1 के लिए मूल्य।

विवरण
रिटर्न string
उदाहरण: z.1.1.7DHps ...