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'sı

Kullanıcılar, yapı başına birden çok aygıtla maksimum üç yapı ekleyebilir.

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

structure_id

Yapının kimlik numarası. Bu veri konumuna bir çağrı yaptığınızda, bu yapıdaki veri değerlerine erişebilirsiniz.

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
Smoke + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda okuma / yazma / v1-v2
ETA yazma / v1-v2
Posta kodu okuma / v2
Kamera okuma / v1-v3
Kamera okuma + görüntüleri / v1-v4
Kamera okuma / yazma / v1-v3
Kamera okuma / yazma + görüntüler / v1-v4
Enerji okuma / v2

termostat

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
Smoke + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda okuma / yazma / v1-v2
ETA yazma / v1-v2
Kamera okuma / v2-v3
Kamera okuma + görüntüleri / 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
Smoke + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda okuma / yazma / v1-v2
ETA yazma / v1-v2
Kamera okuma / v2-v3
Kamera okuma + görüntüleri / 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
Smoke + CO okuma / v4-v5
Dışarıda okuma / v2
Dışarıda okuma / yazma / v2
ETA yazma / v2
Kamera okuma / v1-v3
Kamera okuma + görüntüleri / 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ın mevcudiyetle ilgili iki durumu vardır: home veya away . Evde hiçbir hareket algılanmadığında, yapı home away değişecektir.

ayrıntılar
https://developer-api.nest.com/structures/ structure_id /away
İadeler string
Değerler: "home", "away"
Giriş okuma yazma
Uygun oku:
Termostat okuma / v1-v6
Termostat okuma / yazma / v1-v6
Smoke + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda okuma / yazma / v1-v2
ETA yazma / v1-v2
Yazmak:
Dışarıda 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", "Plaj Evi", "Dağ Evi"
Giriş okuma yazma
Uygun oku:
Termostat okuma / v1-v6
Termostat okuma / yazma / v1-v6
Smoke + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda okuma / yazma / v1-v2
ETA yazma / v1-v2
Posta kodu okuma / v2
Kamera okuma / v1-v3
Kamera okuma + görüntüleri / 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, ISO 3166 alfa-2 biçiminde.

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
Smoke + CO okuma / v1-v5
Dışarıda okuma / v1-v2
Dışarıda 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

Enerji yoğun çalışma saatinin ISO 8601 formatında başlama zamanı.

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

Enerji acele saati etkinliğinin bitiş zamanı, ISO 8601 formatında.

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

IANA zaman dilimi formatında yapıdaki saat dilimi .

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

eta

Tahmini varış süresi (tahmini varış zamanı) bir yapı üzerinde ayarlanabilen bir nesnedir. Nest'e bir kullanıcının belirli bir zamanda eve dönmesi beklendiğini bildirmek için kullanılır. ETA çağrısı yapma hakkında bilgi için Uzak Rehber'e bakın.

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 Geziyi tanımlayan kullanıcı tanımlı bir dize
estimated_arrival_window_begin ISO 8601 formatında bir zaman damgası.
NOW daha büyük olmalıdır.
estimated_arrival_window_end ISO 8601 formatında bir zaman damgası.
Daha büyük olmalıdır estimated_arrival_window_begin .
Giriş salt
Uygun ETA yazma / v1-v2

eta_begin

ISO 8601 formatında beklenen en erken varış zamanının zaman damgası. İşlemleri 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 okuma / v1

rhr_enrollment

Bitirim İkili kayıt durumunu ödüllendirir.

ayrıntılar
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.

ayrıntılar
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
tip string enum
Değerler: "ok", "deter"
Giriş Sadece oku
Uygun Güvenlik durumu okuma / v1

wheres

where_id cihazlar için nerede tanımlayıcıları ( where_id ve name ) içeren bir nesne. name , cihazın görünen adıdır. Sunduğumuz listeden herhangi bir oda adı veya özel bir ad olabilir.

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

Nest Thermostatts , Nest Protects ve Nest Cams için adların nerede olduğu hakkında daha fazla bilgi edinin.

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

where_id

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

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

ayrıntılar
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
İadeler string
Örnek: "Fqp6wJI ..."
Giriş Sadece oku
Uygun oku:
Termostat okuma / v3-v6
Termostat okuma / yazma / v3-v6
Smoke + CO okuma / v3-v5
Kamera okuma / v1-v3
Kamera okuma + görüntüleri / 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 oku:
Termostat okuma / v3-v6
Termostat okuma / yazma / v3-v6
Smoke + CO okuma / v3-v5
Kamera okuma / v1-v3
Kamera okuma + görüntüleri / 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