Google अश्वेत समुदायों के लिए नस्लीय इक्विटी को आगे बढ़ाने के लिए प्रतिबद्ध है। देखो कैसे।
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

संरचना

संरचनाएं

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

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

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

कुछ संरचना-स्तर की विशेषताएं अलग-अलग, अधिक विस्तृत एपीआई गाइडों में शामिल हैं:

संरचना की अनुमति

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

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

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

नाम

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

Wheres

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

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

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 टाइम ज़ोन स्ट्रिंग जो संरचना के टाइम ज़ोन में मैप करता है

संरचना सुविधाएँ

धुआं और सीओ अलार्म राज्यों

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

इन राज्यों के बारे में अधिक जानकारी के लिए स्मोक + सीओ अलार्म गाइड देखें।

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

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

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

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

संरचना पिकर

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

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

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

एक संरचना में नेस्ट कितने उपकरणों का समर्थन करता है, इसकी सीमाएं हैं।

उपकरण का प्रकार अधिकतम संरचना
नेस्ट थर्मोस्टैट 20
नेस्ट कैमरा 10
घोंसला की रक्षा 18

त्रुटि संदेश

एपीआई कॉल त्रुटियों का क्या अर्थ है और उन्हें कैसे संभालना है, इसकी जानकारी के लिए, त्रुटि संदेश देखें।