स्ट्रक्चर्ड एपीआई

उपयोगकर्ता हर डिवाइस के लिए एक से ज़्यादा डिवाइस के साथ ज़्यादा से ज़्यादा तीन स्ट्रक्चर जोड़ सकते हैं.

नीचे दिए गए सभी मान, JSON दस्तावेज़ में मौजूद हर structures/structure_id के तहत मिलते हैं.

संरचना_आईडी

संरचना का आईडी नंबर. जब आप इस डेटा लोकेशन पर कॉल करते हैं, तो आप इस स्ट्रक्चर में डेटा वैल्यू को ऐक्सेस कर सकते हैं.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/structure_id
लौटाए गए सामानstring
उदाहरण: &quat;VqFabWH21nw...&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैThermostat read / v1-v6
Thermostat read/write / v1-v6
Smoke+CO read / v1-v5
Away read / v1-v2
Away read/write / v1-v2
ETA write / v1-v2
Postal code read / v2
Camera read / v1-v3
Camera read + images / v1-v4
Camera read/write / v1-v3
Camera read/write + images / v1-v4
Energy read / v2

थर्मोस्टैट

खास डिवाइस आइडेंटिफ़ायर के मुताबिक, स्ट्रक्चर में मौजूद थर्मोस्टैट की सूची. यह JSON ऑब्जेक्ट की एक श्रेणी है जिसमें स्ट्रक्चर में मौजूद सभी थर्मोस्टैट शामिल हैं.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/thermostats
लौटाए गए सामानarray
उदाहरण: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैThermostat read / v1-v6
Thermostat read/write / v1-v6
Smoke+CO read / v1-v5
Away read / v1-v2
Away read/write / v1-v2
ETA write / v1-v2
Camera read / v2-v3
Camera read + images / v2-v4
Camera read/write / v2-v3
Camera read/write + images / v2-v4

धुएं_को_अलार्म

खास डिवाइस आइडेंटिफ़ायर की मदद से, स्ट्रक्चर में धुएं और कार्बन मोनोऑक्साइड के अलार्म की सूची. यह JSON ऑब्जेक्ट की एक कैटगरी है जिसमें धुएं और कार्बन मोनोऑक्साइड के सभी अलार्म शामिल हैं.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/smoke_co_alarms
लौटाए गए सामानarray
उदाहरण: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैThermostat read / v1-v6
Thermostat read/write / v1-v6
Smoke+CO read / v1-v5
Away read / v1-v2
Away read/write / v1-v2
ETA write / v1-v2
Camera read / v2-v3
Camera read + images / v2-v4
Camera read/write / v2-v3
Camera read/write + images / v2-v4

कैमरे

खास डिवाइस आइडेंटिफ़ायर के मुताबिक, स्ट्रक्चर में कैमरों की सूची. यह JSON ऑब्जेक्ट की एक कैटगरी है जिसमें स्ट्रक्चर के सभी कैमरे शामिल हैं.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/cameras
लौटाए गए सामानarray
उदाहरण: [ "awJo6rH...",... ]
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैमेरी -

दूर

संरचना की व्यस्तता की स्थिति के बारे में बताता है.

संरचना की मौजूदगी से संबंधित दो राज्य हैं: home या away. अगर घर में किसी तरह की हलचल नहीं होती है, तो स्ट्रक्चर home से away में बदल जाएगा.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/away
लौटाए गए सामानstring
वैल्यू: &कोटेशन;होम & कोट;, &कोटेशन;बेवकूफ़;
ऐक्सेस करनापढ़ें/लिखें
इसमें उपलब्ध है1 x के विषय के टेक्स्ट दर्शक

नाम

संरचना का उपयोगकर्ता-परिभाषित प्रदर्शन नाम.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/name
लौटाए गए सामानstring
उदाहरण: &कोटेशन;मेरा होम&कोट;, &कोटेशन; बीच हाउस&कोट्स; और &कोटेशन;माउंटेन हाउस&कोटेशन;
ऐक्सेस करनापढ़ें/लिखें
इसमें उपलब्ध हैGoogle टीम

Country_code (देश_कोड)

देश कोड, ISO 3166 alpha-2 फ़ॉर्मैट में.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/country_code
लौटाए गए सामानstring
उदाहरण: &कोटेशन;अमेरिका&kot;, &कोटेशन;कनाडा&&कोटेशन; यूके&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैथर्मोस्टैट को पढ़ने / v1-v6
थर्मोस्टैट को पढ़ने/लिखने के लिए / v1-v6
स्मोक+को पढ़ने / v1-v5
अवे / v1-v2
दूर से पढ़ने/लिखने / v1-v2
ईटीए को लिखने / v1-v2

पिन कोड [postal_code]

देश के आधार पर डाक या पिन कोड.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/postal_code
लौटाए गए सामानstring
उदाहरण: &कोटेशन;94304&कोटेशन;, &कोटेशन;94304-1027&कोटेशन;, &कोटेशन;EC1A 1BB&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैपिन कोड / v1-v2

पीक_पीरियड_start_time

ISO 8601 फ़ॉर्मैट में, बिजली की ज़्यादा खपत वाले इवेंट के शुरू होने का समय.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/peak_period_start_time
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-31T23:59:59.000Z&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैथर्मोस्टैट को पढ़ने / v1-v6
थर्मोस्टैट को पढ़ने/लिखने के लिए / v1-v6
ऊर्जा को पढ़ने की सुविधा / v1-v2

पीक_पीरियड_एंड_समय

ISO 8601 फ़ॉर्मैट में, बिजली की ज़्यादा खपत वाले इवेंट के खत्म होने का समय.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/peak_period_end_time
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-31T23:59:59.000Z&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैथर्मोस्टैट को पढ़ने / v1-v6
थर्मोस्टैट को पढ़ने/लिखने के लिए / v1-v6
ऊर्जा को पढ़ने की सुविधा / v1-v2

समय_क्षेत्र

स्ट्रक्चर पर समय क्षेत्र, IANA समय क्षेत्र में.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/time_zone
लौटाए गए सामानstring
उदाहरण: "अमेरिका/Los_Angeles&quat;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैथर्मोस्टैट को पढ़ने / v1-v6
थर्मोस्टैट को पढ़ने/लिखने के लिए v1-v6
स्मोक+को पढ़ने / v1-v5
अवे / v1-v2
अवे मोड से पढ़ने/लिखने / v2
ईटीए को लिखने / v1-v2

पहुंचने का अनुमानित समय

आप पहुंचने का अनुमानित समय ईटीए है, जिसे किसी स्ट्रक्चर पर सेट किया जा सकता है. इसका इस्तेमाल Nest को यह बताने के लिए किया जाता है कि उपयोगकर्ता किसी खास समय पर घर लौट सकता है. ETA कॉल करने का तरीका जानने के लिए, अवे गाइड देखें.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/eta
लौटाए गए सामानobject
उदाहरण: &कोटेशन;myTripID1024&कोट
पैरामीटर
trip_idयात्रा की पहचान करने वाली उपयोगकर्ता की ओर से तय की गई स्ट्रिंग
estimated_arrival_window_begin ISO 8601 फ़ॉर्मैट में टाइमस्टैंप.
का मान NOW से ज़्यादा होना चाहिए.
estimated_arrival_window_endISO 8601 फ़ॉर्मैट में टाइमस्टैंप.
का मान estimated_arrival_window_begin से ज़्यादा होना चाहिए.
ऐक्सेस करनासिर्फ़ लिखने के लिए
इसमें उपलब्ध हैETA / v1-v2

ETA

ISO 8601 फ़ॉर्मैट में, पहुंचने का सबसे नज़दीकी अनुमानित समय का टाइमस्टैंप. इसका इस्तेमाल कार्रवाइयों या इवेंट को ट्रिगर करने के लिए किया जाता है.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/eta_begin
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-31T23:59:59.000Z&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैईटीए पढ़ने / v1

Rhr_नाम दर्ज

बिजली की कम खपत करने पर रिवॉर्ड देने वाले कार्यक्रम में नाम दर्ज करने की स्थिति.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/rhr_enrollment
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैएनर्जी रीड / v1-v2

AWN_security_state

स्ट्रक्चर की सुरक्षा की स्थिति.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/wwn_security_state
स्ट्रीम किस तरह की हैstring enum
वैल्यू: &कोटेशन;ठीक &;कोटेशन
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैसुरक्षा स्थिति / v1

कहाँ

एक ऑब्जेक्ट जिसमें संरचना के डिवाइस के लिए पहचानकर्ता (where_id और name) हैं. डिवाइस का डिसप्ले नाम name है. आप चैट रूम का नाम या अपनी पसंद के मुताबिक सूची दे सकते हैं.

wheres पर और जानकारी के लिए, संरचना मार्गदर्शिका देखें.

Nest Thermostat, Nest Protect, और Nest Cam के नाम के बारे में ज़्यादा जानें.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/wheres
लौटाए गए सामानobject
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध है. कोई वीडियो, वीडियो

Where_id

Nest को जनरेट करने वाला एक यूनीक आइडेंटिफ़ायर, जो name के बारे में बताता है.

where_id बनाने के लिए, अपने-आप बन जाता है और कॉल के दौरान दिखता है name.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/wheres/where_id/where_id
लौटाए गए सामानstring
उदाहरण: &कोटेशन;Fqp6wJI...&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैरीड

नाम

डिवाइस का डिसप्ले नाम.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/wheres/where_id/name
लौटाए गए सामानstring
उदाहरण: "Bedroom&कोटेशन;
ऐक्सेस करनापढ़ें/लिखें
इसमें उपलब्ध है. कोई वीडियो, वीडियो

co_alarm_state

CO अलार्म की स्थिति.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/co_alarm_state
लौटाए गए सामानstring enum
वैल्यू: &कोटेशन;ठीक &;कोटेशन; चेतावनी और कोटेशन; &कोटेशन
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैधुएं+CO / v5

धूम्रपान_अलार्म_राज्य

धुएँ के अलार्म की स्थिति.

ब्यौरा
https://developer-api.nest.com/structures/structure_id/smoke_alarm_state
लौटाए गए सामानstring enum
वैल्यू: &कोटेशन;ठीक &;कोटेशन; चेतावनी और कोटेशन; &कोटेशन
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैधुएं+CO / v5