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

Yapı API'si

Kullanıcılar ekleyebilir üç yapıların maksimum yapısına göre birden fazla cihaz ile.

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 çağrı yaptığınızda bu yapıdaki veri değerlerine ulaşabilirsiniz.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /structure_id
İadeler string
Örnek: "VqFabWH21nw..."
Giriş Sadece oku
Uygun Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Duman+CO okuma / v1-v5
Uzakta okuma / v1-v2
Uzakta okuma/yazma / v1-v2
ETA yazma / v1-v2
Posta kodu okuma / v2
Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / 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.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /thermostats
İadeler array
Örnek: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Giriş Sadece oku
Uygun Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Duman+CO okuma / v1-v5
Uzakta okuma / v1-v2
Uzakta okuma/yazma / v1-v2
ETA yazma / v1-v2
Kamera okuması / v2-v3
Kamera okuma + görüntüler / v2-v4
Kamera okuma/yazma / v2-v3
Kamera okuma/yazma + görüntüler / 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.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
İadeler array
Örnek: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Giriş Sadece oku
Uygun Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Duman+CO okuma / v1-v5
Uzakta okuma / v1-v2
Uzakta okuma/yazma / v1-v2
ETA yazma / v1-v2
Kamera okuması / v2-v3
Kamera okuma + görüntüler / v2-v4
Kamera okuma/yazma / v2-v3
Kamera okuma/yazma + görüntüler / 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.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /cameras
İadeler array
Örnek: [ "awJo6rH...",... ]
Giriş Sadece oku
Uygun Termostat okuma / v4-v6
Termostat okuma/yazma / v4-v6
Duman+CO okuma / v4-v5
Dışarıda okuma / v2
Uzakta okuma/yazma / v2
ETA yazma / v2
Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

uzakta

Yapının doluluk durumunu gösterir.

: Yapılar varlığına ilişkin iki duruma sahip home veya away . Hiçbir hareket evinde hissedildiğinde yapısı değişecektir home için away .

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /away
İadeler string
Değerler: "ev", "uzakta"
Giriş okuma yazma
Uygun Okuyun:
Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Duman+CO okuma / v1-v5
Uzakta okuma / v1-v2
Uzakta okuma/yazma / v1-v2
ETA yazma / v1-v2
Yazmak:
Uzakta okuma/yazma / v1-v2

isim

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

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /name
İadeler string
Örnekler: "Evim", "Sahildeki Ev", "Dağdaki Ev"
Giriş okuma yazma
Uygun Okuyun:
Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Duman+CO okuma / v1-v5
Uzakta okuma / v1-v2
Uzakta okuma/yazma / v1-v2
ETA yazma / v1-v2
Posta kodu okuma / v2
Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4
Enerji okuma / v2
Yapı okuma/yazma / v1
Yazmak:
Yapı okuma/yazma / v1

ülke kodu

Ülke kodu, içinde ISO 3166 alfa-2 biçimi.

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

posta kodu

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

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

peak_period_start_time

Başlangıç zamanı enerji yoğun saat içinde, olay ISO 8601 biçimini.

Ayrıntılar
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 okuma / v1-v6
Termostat okuma/yazma / v1-v6
Enerji okuma / v1-v2

peak_period_end_time

Zamanını End enerji yoğun saat içinde, olay ISO 8601 biçimini.

Ayrıntılar
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 okuma / v1-v6
Termostat okuma/yazma / v1-v6
Enerji okuma / v1-v2

saat dilimi

Yapı geçirilen zaman dilimi, IANA saat dilimi biçiminde.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /time_zone
İadeler string
Örnek: "Amerika/Los_Angeles"
Giriş Sadece oku
Uygun Termostat okuma / v1-v6
Termostat okuma/yazma / v1-v6
Duman+CO okuma / v1-v5
Uzakta okuma / v1-v2
Uzakta okuma/yazma / v2
ETA yazma / v1-v2

eta

ETA (tahmini varış zamanı), bir yapı üzerinde ayarlanabilen bir nesnedir. Nest'e bir kullanıcının belirli bir zamanda eve dönmesinin beklendiğini bildirmek için kullanılır. Bir ETA arama yapmak konusunda bilgi için, bkz Kılavuzu Dışarıda .

Ayrıntılar
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 Yolculuğu tanımlayan kullanıcı tanımlı bir dize
estimated_arrival_window_begin Bir zaman damgası ISO 8601 formatında.
Daha büyük olmalıdır NOW .
estimated_arrival_window_end Bir zaman damgası ISO 8601 formatında.
Daha büyük olmalıdır estimated_arrival_window_begin .
Giriş salt yazılır
Uygun ETA yazma / v1-v2

eta_begin

Varış erken beklenen zaman zaman damgası ISO 8601 formatında. Eylemleri veya olayları tetiklemek için kullanılır.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /eta_begin
İadeler string
Örnek: "2016-12-31T23:59:59.000Z"
Giriş Sadece oku
Uygun ETA okuması / v1

rhr_enrollment

Bitirim İkili Ödül kaydı durumu.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Enerji okuma / v1-v2

wwn_security_state

Yapı güvenlik durumu.

Ayrıntılar
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 okuma / v1

nerede

İçeren bir nesne burada tanımlayıcıları ( where_id ve name yapısında cihazlar için). name cihazın görüntü adıdır. Sağladığımız bir listedeki herhangi bir oda adı veya özel bir ad olabilir.

Hakkında daha fazla bilgi için wheres , bkz Yapısı Kılavuzu .

Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /wheres
İadeler object
Giriş Sadece oku
Uygun Okuyun:
Termostat okuma / v3-v6
Termostat okuma/yazma / v3-v6
Duman+CO okuma / v3-v5
Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

nerede_kimlik

Temsil eden bir tek, Yuva oluşturulan tanımlayıcı name .

where_id otomatik olarak oluşturulur ve oluşturmak için çağrı sırasında döndürülen name .

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
İadeler string
Örnek: "Fqp6wJI..."
Giriş Sadece oku
Uygun Okuyun:
Termostat okuma / v3-v6
Termostat okuma/yazma / v3-v6
Duman+CO okuma / v3-v5
Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

isim

Cihazın görünen adı.

Ayrıntılar
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
İadeler string
Örnek: "Yatak odası"
Giriş okuma yazma
Uygun Okuyun:
Termostat okuma / v3-v6
Termostat okuma/yazma / v3-v6
Duman+CO okuma / v3-v5
Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

co_alarm_state

CO alarm durumu.

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

Smoke_alarm_state

Duman alarmı durumu.

Ayrıntılar
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