Google is committed to advancing racial equity for Black communities. See how.

संरचना

संरचनाओं

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

नेस्ट एपीआई निम्नलिखित संरचना-स्तर के डेटा दी गई अनुमतियों के स्तर पर निर्भर करने के लिए पहुँच प्रदान करता है:

  • संरचना का नाम और उपकरण "जहां नाम" (घर में स्थान)
  • घर में उपकरणों की सूची
  • ऊर्जा घटना स्थिति ( ऊर्जा भीड़ घंटे )
  • दूर राज्य
  • उपयोगकर्ता ईटीए
  • सुरक्षा स्थिति
  • डाक या ज़िप कोड

कुछ संरचना-स्तरीय विशेषताएं अलग, अधिक विस्तृत API मार्गदर्शिकाओं में शामिल हैं:

संरचना अनुमतियाँ

प्रवेश के लिए... चुनते हैं...
में अधिकांश डेटा मान structures वस्तु दूर , ईटीए , ऊर्जा , या डाक कोड अनुमतियाँ
name में डेटा मान structures वस्तु संरचना पढ़ें / लिखें अनुमति

कैसे अनुमतियों में कार्य करती हैं इंटरैक्टिव API संदर्भ

संरचना पहचानकर्ता

नाम

संरचना का नाम डिफ़ॉल्ट रूप से "होम" है, लेकिन उपयोगकर्ता द्वारा चुनी गई कोई भी स्ट्रिंग हो सकती है। जब आप चुनें संरचना पढ़ने / लिखने की अनुमति है, तो आप संरचना को बदल सकते हैं name

कहां

wheres एक संरचना पर एक वस्तु सेट, युक्त जहां पहचानकर्ता (है where_id और name )। उपयोग wheres कस्टम जहां बनाने के लिए नाम, या उपयोग मानक जहां नाम।

तक पहुंच wheres वस्तु की आवश्यकता है कैमरा , स्मोक + CO अलार्म , या थर्मोस्टेट अनुमतियाँ।

where_id

  • एक अनूठा, घोंसला-उत्पन्न पहचानकर्ता का प्रतिनिधित्व करता है name
  • where_id , केवल पढ़ने के लिए और एक कस्टम जहां बनाने के लिए कॉल में अपने आप बन जाता name

name

  • डिवाइस का प्रदर्शन नाम; हमारे द्वारा प्रदान की गई सूची में से किसी भी कमरे का नाम या कस्टम नाम हो सकता है
  • एक कस्टम जहां बनाने के लिए name , एक पोस्ट कॉल एक नया, कस्टम लिखने के लिए बनाने के जहां name ; where_id कॉल में दिया जाता है
  • विचार
    • name संपादित नहीं किया जा सकता है या निर्माण के बाद नष्ट कर दिया
    • name ढांचे के भीतर अद्वितीय होना चाहिए
    • एक डिवाइस एक संरचना, कस्टम जहां से जोड़ा बनाया जाता है, तो name डिवाइस से संबद्ध से पहुँचा जा सकता है /structures/ पथ
    • एक कस्टम के साथ एक उपकरण ले जाने के लिए जहां name एक अलग संरचना करने के लिए, डिवाइस युग्मन हटाना, और फिर डिवाइस को वांछित नाम के साथ फिर से जोड़ी

के लिए नामों के बारे में और जानें नेस्ट ऊष्मातापी ,घोंसला की रक्षा करता है और घोंसला कैम

अन्य मेटाडेटा

सभी डेटा मान केवल पढ़े जाते हैं, जब तक कि अन्यथा निर्दिष्ट न हो।

डेटा का मान विवरण
structure_id एक स्ट्रिंग जो विशिष्ट रूप से इस संरचना का प्रतिनिधित्व करती है। प्रत्येक डेवलपर को एक ही संरचना के लिए एक अलग आईडी दिखाई देगी, लेकिन एक ही डेवलपर के कई उत्पादों को एक ही आईडी दिखाई देगी
country_code एक आईएसओ 3166-1 अल्फा -2 देश कोड जो संरचना के पंजीकृत स्थान पर मैप करता है
postal_code डाक या ज़िप कोड, देश पर निर्भर करता है
time_zone एक IANA समय क्षेत्र स्ट्रिंग है जो संरचना के समय क्षेत्र के नक्शे

संरचना विशेषताएं

धुआं और सीओ अलार्म बताता है

आप चुनते हैं जब स्मोक + CO अनुमति पढ़ा , तो आप उपयोग कर सकते हैं smoke_alarm_state और co_alarm_state में structures वस्तु। ये वही डेटा मान भी डिवाइस ऑब्जेक्ट (में उपलब्ध हैं devices/smoke_co_alarms )।

देखें धुआँ CO अलार्म गाइड + इन राज्यों में अधिक जानकारी के लिए।

कई डेटा मान यह निर्धारित करने के लिए एक साथ काम करते हैं कि डिवाइस किसी संरचना में कैसे व्यवहार करते हैं।

  • एक संरचना जब away राज्य के लिए निर्धारित है away शब्द "पर्यावरण" उपयोगकर्ता की पसंदीदा भाषा में, नेस्ट थर्मोस्टेट पर प्रदर्शित होता है
  • एक संरचना जब away राज्य के लिए निर्धारित है away , आप कर सकते हैं:
    • सेट fan_timer_active
    • परिवर्तन target_temperature_f या target_temperature_c
  • एक संरचना जब away राज्य के लिए निर्धारित है home , आप कर सकते हैं:
    • ईटीए कॉल करें (ट्रिप आईडी और आगमन विंडो सेट करें)
  • जब आपातकालीन Shutoff सक्रिय हैं, आप निर्धारित नहीं कर सकते fan_timer_active
  • जब आपातकालीन हीट सक्रिय है, आप करने के लिए संरचना नहीं निर्धारित कर सकते हैं कर सकते हैं away

एकाधिक संरचनाएं

यह संभव है कि किसी उपयोगकर्ता के पास उनके Nest खाते से जुड़ी एक से अधिक संरचना हो, इसलिए आपके उत्पाद को उपयोगकर्ता को उपलब्ध संरचनाओं (एक संरचना पिकर) से चुनने का एक साधन प्रदान करना चाहिए।

संरचना पिकर

उदाहरण के लिए, ईटीए सेट करते समय, यह महत्वपूर्ण है कि उपयोगकर्ता ईटीए गंतव्य के लिए एक संरचना चुनने में सक्षम हो। इसी तरह, एक उपयोगकर्ता के पास दो अलग-अलग घरों के "लिविंग रूम" में दो स्मोक डिटेक्टर हो सकते हैं। यदि आपको घर की अपनी अवधारणा के साथ संरचना सहसंबंध करने की आवश्यकता है, तो हम अनुशंसा करते हैं कि आप प्राधिकरण प्रक्रिया के दौरान ऐसा करें।

जानें कि कैसे उपयोगकर्ताओं को एकाधिक संरचनाओं में उपकरणों का प्रबंधन

डिवाइस मैक्सिमम

किसी संरचना में Nest कितने डिवाइस का समर्थन करता है, इसकी सीमाएं हैं।

उपकरण का प्रकार अधिकतम प्रति संरचना
नेस्ट थर्मोस्टेट 20
नेस्ट कैमरा 10
नेस्ट प्रोटेक्ट १८

त्रुटि संदेश

API कॉल त्रुटियों क्या मतलब है और उन्हें कैसे संभाल करने के लिए, को देखने के बारे में जानकारी के लिए त्रुटि संदेश