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.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Yapı API'si

Kullanıcılar, yapı başına birden fazla cihazla maksimum üç yapı ekleyebilir.

Değerlerin altında tüm her birinin altında bulunan structures/ structure_id JSON belgede.

yapı_kimliği

Yapının kimlik numarası. Bu veri konumuna bir arama yaptığınızda bu yapıdaki veri değerlerine ulaşabilirsiniz.

Detaylar
https://developer-api.nest.com/structures/ structure_id /structure_id
İadeler string
Örnek: "VqFabWH21nw ..."
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Uzakta okuma / v1-v2
Dışarıda oku / yaz / v1-v2
ETA yazma / v1-v2
Posta kodu okundu / v2
Kamera okuma / v1-v3
Kamera + resimler / v1-v4 oku
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + resimler / v1-v4
Enerji okuma / v2

termostatlar

Benzersiz cihaz tanımlayıcısına göre yapıdaki termostatların listesi. Bu, yapıdaki tüm termostatları içeren bir JSON nesneleri dizisidir.

Detaylar
https://developer-api.nest.com/structures/ structure_id /thermostats
İadeler array
Örnek: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Uzakta okuma / v1-v2
Dışarıda oku / yaz / v1-v2
ETA yazma / v1-v2
Kamera oku / v2-v3
Kamera + resimler / v2-v4 oku
Kamera okuma / yazma / v2-v3
Kamera okuma / yazma + resimler / v2-v4

smoke_co_alarms

Benzersiz cihaz tanımlayıcısına göre yapıdaki duman + CO alarmlarının listesi. Bu, yapıdaki tüm duman + CO alarmlarını içeren bir JSON nesneleri dizisidir.

Detaylar
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
İadeler array
Örnek: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda oku / yaz / v1-v2
ETA yazma / v1-v2
Kamera oku / v2-v3
Kamera + resimler / v2-v4 oku
Kamera okuma / yazma / v2-v3
Kamera okuma / yazma + resimler / v2-v4

kameralar

Benzersiz cihaz tanımlayıcısına göre yapıdaki kameraların listesi. Bu, yapıdaki tüm kameraları içeren bir JSON nesneleri dizisidir.

Detaylar
https://developer-api.nest.com/structures/ structure_id /cameras
İadeler array
Örnek: [ "awJo6rH...",... ]
Giriş Sadece oku
Uygun Termostat oku / v4-v6
Termostat okuma / yazma / v4-v6
Duman + CO okuma / v4-v5
Uzakta oku / v2
Uzakta oku / yaz / v2
ETA yazma / v2
Kamera okuma / v1-v3
Kamera + resimler / v1-v4 oku
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + resimler / v1-v4

uzakta

Yapının doluluk durumunu gösterir.

Yapıların mevcudiyetle ilgili iki durumu vardır: home veya away . Evde hiçbir hareket algılanmadığında, yapı home away değişecektir.

Detaylar
https://developer-api.nest.com/structures/ structure_id /away
İadeler string
Değerler: "ev", "uzakta"
Giriş okuma yazma
Uygun Oku:
Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Uzakta okuma / v1-v2
Dışarıda oku / yaz / v1-v2
ETA yazma / v1-v2
Yazmak:
Dışarıda oku / yaz / v1-v2

isim

Yapının kullanıcı tanımlı görünen adı.

Detaylar
https://developer-api.nest.com/structures/ structure_id /name
İadeler string
Örnekler: "Evim", "Sahil Evi", "Dağ Evi"
Giriş okuma yazma
Uygun Oku:
Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Uzakta okuma / v1-v2
Dışarıda oku / yaz / v1-v2
ETA yazma / v1-v2
Posta kodu okundu / v2
Kamera okuma / v1-v3
Kamera + resimler / v1-v4 oku
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + resimler / v1-v4
Enerji okuma / v2
Yapı okuma / yazma / v1
Yazmak:
Yapı okuma / yazma / v1

ülke kodu

Ülke kodu, ISO 3166 alfa-2 biçiminde.

Detaylar
https://developer-api.nest.com/structures/ structure_id /country_code
İadeler string
Örnekler: "ABD", "CA", "İngiltere"
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Uzakta okuma / v1-v2
Dışarıda oku / yaz / v1-v2
ETA yazma / v1-v2

posta kodu

Ülkeye bağlı olarak posta veya posta kodu.

Detaylar
https://developer-api.nest.com/structures/ structure_id /postal_code
İadeler string
Örnekler: "94304", "94304-1027", "EC1A 1BB"
Giriş Sadece oku
Uygun Posta kodu okundu / v1-v2

peak_period_start_time

Enerjiye yoğun saat olayının ISO 8601 biçiminde başlama saati .

Detaylar
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
İadeler string
Örnek: "2016-12-31T23: 59: 59.000Z"
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Enerji okuma / v1-v2

peak_period_end_time

Enerji yoğun saat etkinliğinin ISO 8601 formatında bitiş zamanı.

Detaylar
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
İadeler string
Örnek: "2016-12-31T23: 59: 59.000Z"
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Enerji okuma / v1-v2

saat dilimi

Yapıda, IANA saat dilimi biçiminde saat dilimi .

Detaylar
https://developer-api.nest.com/structures/ structure_id /time_zone
İadeler string
Örnek: "America / Los_Angeles"
Giriş Sadece oku
Uygun Termostat oku / v1-v6
Termostat okuma / yazma / v1-v6
Duman + CO okuma / v1-v5
Uzakta okuma / v1-v2
Dışarıda oku / yaz / v2
ETA yazma / v1-v2

eta

ETA (tahmini varış zamanı), bir yapı üzerinde ayarlanabilen bir nesnedir. Nest'in bir kullanıcının belirli bir zamanda eve dönmesinin beklendiğini bilmesini sağlamak için kullanılır. ETA aramasının nasıl yapılacağı hakkında bilgi için Uzakta Rehberi'ne bakın .

Detaylar
https://developer-api.nest.com/structures/ structure_id /eta
İadeler object
Örnek: "myTripID1024", "2014-10-31T22: 42: 00.000Z", "2016-12-31T23: 59: 59.000Z"
Parametreler
trip_id Geziyi tanımlayan kullanıcı tanımlı bir dize
estimated_arrival_window_begin ISO 8601 biçiminde bir zaman damgası.
NOW büyük olmalıdır.
estimated_arrival_window_end ISO 8601 biçiminde bir zaman damgası.
estimated_arrival_window_begin edilen_varış_başlangıç ​​penceresinden büyük olmalıdır.
Giriş salt yazılır
Uygun ETA yazma / v1-v2

eta_begin

ISO 8601 biçiminde beklenen en erken varış zamanının zaman damgası. Eylemleri veya olayları tetiklemek için kullanılır.

Detaylar
https://developer-api.nest.com/structures/ structure_id /eta_begin
İadeler string
Örnek: "2016-12-31T23: 59: 59.000Z"
Giriş Sadece oku
Uygun Tahmini varış zamanı / v1

rhr_enrollment

Rush Hour Rewards kayıt durumu.

Detaylar
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
İadeler boolean
Değerler: true, false
Giriş Sadece oku
Uygun Enerji okuma / v1-v2

wwn_security_state

Yapı güvenlik durumu.

Detaylar
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
Tür string enum
Değerler: "tamam", "caydırıcı"
Giriş Sadece oku
Uygun Güvenlik durumu oku / v1

nerede

where_id aygıtlar için nerede tanımlayıcıları ( where_id ve name ) içeren bir nesne. name , cihazın görünen adıdır. Sağladığımız bir listedeki herhangi bir oda adı veya özel bir ad olabilir.

wheres hakkında daha fazla bilgi için Yapı Kılavuzu'na bakın .

Nest Thermostats ,Nest Protects ve Nest Cams adlarının nerede olduğu hakkında daha fazla bilgi edinin.

Detaylar
https://developer-api.nest.com/structures/ structure_id /wheres
İadeler object
Giriş Sadece oku
Uygun Oku:
Termostat oku / v3-v6
Termostat okuma / yazma / v3-v6
Duman + CO okuma / v3-v5
Kamera okuma / v1-v3
Kamera + resimler / v1-v4 oku
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + resimler / v1-v4

where_id

name temsil eden, Nest tarafından oluşturulmuş benzersiz bir tanımlayıcı.

where_id otomatik olarak oluşturulur ve name oluşturma çağrısı sırasında döndürülür.

Detaylar
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
İadeler string
Örnek: "Fqp6wJI ..."
Giriş Sadece oku
Uygun Oku:
Termostat oku / v3-v6
Termostat okuma / yazma / v3-v6
Duman + CO okuma / v3-v5
Kamera okuma / v1-v3
Kamera + resimler / v1-v4 oku
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + resimler / v1-v4

isim

Cihazın görünen adı.

Detaylar
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
İadeler string
Örnek: "Yatak odası"
Giriş okuma yazma
Uygun Oku:
Termostat oku / v3-v6
Termostat okuma / yazma / v3-v6
Duman + CO okuma / v3-v5
Kamera okuma / v1-v3
Kamera + resimler / v1-v4 oku
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + resimler / v1-v4

co_alarm_state

CO alarm durumu.

Detaylar
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
İadeler string enum
Değerler: "ok", "uyarı", "acil durum"
Giriş Sadece oku
Uygun Duman + CO okuma / v5

smoke_alarm_state

Duman alarmı durumu.

Detaylar
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
İadeler string enum
Değerler: "tamam", "uyarı", "acil durum"
Giriş Sadece oku
Uygun Duman + CO okuma / v5