Google, Siyah topluluklar için ırksal eşitliği ilerletmeye kararlıdır. Nasıl olduğunu gör.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

yapı

Yapılar

Yuva yapıları gerçek dünyadaki fiziksel yapıları temsil eder. Genellikle bir kullanıcının evi, cihazlar için bir düzenleme noktası görevi görür ve tüm ev için geçerli olan verileri depolar.

Nest API , verilen izin düzeyine bağlı olarak aşağıdaki yapı düzeyindeki verilere erişim sağlar:

  • Yapı adı ve "nerede ad" cihazı (evdeki konum)
  • Evdeki cihazların listesi
  • Enerji olay durumu ( enerji çalışma saati )
  • Deplasman durumu
  • Kullanıcı ETA'sı
  • Güvenlik durumu
  • Posta veya posta kodu

Bazı yapı düzeyindeki özellikler, ayrı ve daha ayrıntılı API kılavuzlarında ele alınmıştır:

Yapı izinleri

Erişim için ... Seç ...
structures nesnesindeki çoğu veri değeri Dışarıda , ETA , Enerji veya Posta kodu izinleri
structures nesnesindeki name veri değeri Yapı okuma / yazma izni

Etkileşimli API Başvurusu'nda izinlerin nasıl çalıştığını görün.

Yapı tanımlayıcıları

ad

Yapının adı varsayılan olarak "Ana Sayfa" dır, ancak kullanıcının seçtiği herhangi bir dize olabilir. Yapı okuma / yazma iznini seçtiğinizde, yapı name değiştirebilirsiniz.

Nerede

wheres burada tanımlayıcıları (ihtiva eden bir yapı üzerine bir amacı grubu olduğu where_id ve name ). Özel adlar oluşturmak için wheres kullanın veya adların standardına erişin.

wheres nesnesine erişim için Kamera , Duman + CO Alarmı veya Termostat izinleri gerekir.

where_id

  • name temsil eden, Nest tarafından oluşturulan benzersiz bir tanımlayıcı
  • where_id salt okunurdur ve özel bir name oluşturmak için çağrıda otomatik olarak oluşturulur

name

  • Cihazın görünen adı; sağladığımız listeden herhangi bir oda adı veya özel bir ad olabilir
  • Özel bir name oluşturmak için, yeni, özel bir name yazmak için POST çağrısı yapın; where_id döndürülür
  • hususlar
    • name oluşturulduktan sonra düzenlenemez veya silinemez
    • name , yapı içinde benzersiz olmalıdır
    • Bir cihaz bir yapı, özel eşlenmiş ise name cihazı ile bağlantılı erişilebilen /structures/ yolu
    • Özel bir name içeren bir cihazı farklı bir yapıya taşımak için, cihazın eşleştirmesini kaldırın ve ardından cihazı istediğiniz adla yeniden eşleştirin

Nest Thermostatts , Nest Protects ve Nest Cams adları hakkında daha fazla bilgi edinin.

Diğer meta veriler

Aksi belirtilmedikçe tüm veri değerleri salt okunurdur.

Veri değeri Açıklama
structure_id Bu yapıyı benzersiz bir şekilde temsil eden bir dize. Her geliştirici aynı yapı için farklı bir kimlik görür, ancak aynı geliştiriciden gelen birden fazla ürün aynı kimliği görür
country_code Yapının kayıtlı konumu ile eşleşen bir ISO 3166-1 alfa-2 ülke kodu
postal_code Ülkeye bağlı olarak posta veya posta kodu
time_zone Yapının saat dilimi ile eşleşen bir IANA zaman dilimi dizesi

Yapı özellikleri

Duman ve CO alarm durumları

Smoke + CO okuma iznini seçtiğinizde, structures nesnesinde smoke_alarm_state ve co_alarm_state erişebilirsiniz. Aynı veri değerleri aygıt nesnesinde de bulunur ( devices/smoke_co_alarms ).

Bu durumlar hakkında daha fazla bilgi için Smoke + CO alarm kılavuzuna bakın.

Birçok veri değeri, cihazların bir yapıda nasıl davrandığını belirlemek için birlikte çalışır.

  • Bir yapı ne zaman away devlet olarak ayarlanır away kelime "ECO" kullanıcının tercih ettiği dilde, Nest Termostat görüntülenir
  • Bir yapı ne zaman away devlet olarak ayarlanır away , şunları yapabilirsiniz:
    • fan_timer_active
    • target_temperature_f veya target_temperature_c değiştir
  • Bir yapı away durumu home olarak ayarlandığında şunları yapabilirsiniz:
    • ETA çağrısı yap (gezi kimliği ve varış penceresini ayarla)
  • Acil Durum Kapatma etkin olduğunda fan_timer_active ayarlayamazsınız
  • Acil Isı etkinleştirildiğinde, yapıyı away ayarlayamazsınız

Çoklu yapılar

Bir kullanıcının Nest Account'a bağlı birden fazla yapısı olması mümkündür, bu nedenle ürününüz, kullanıcının mevcut yapılardan (bir yapı seçici) seçim yapması için bir araç sunmalıdır.

Yapı seçici

Örneğin, ETA'yı ayarlarken, kullanıcının ETA hedefi için bir yapı seçebilmesi önemlidir. Benzer şekilde, bir kullanıcının iki farklı evin "oturma odasında" iki duman detektörü olabilir. Kendi ev konseptinizle yapı korelasyonu yapmanız gerekiyorsa, bunu yetkilendirme işlemi sırasında yapmanızı öneririz.

Kullanıcıların birden çok yapıdaki cihazları nasıl yönettiğini öğrenin.

Cihaz maksimumları

Nest'in bir yapıda kaç cihazı desteklediğinin sınırları vardır.

Cihaz tipi Yapı başına maksimum
Nest Termostat 20
Nest Kameralar 10
Nest Protect 18

Hata mesajları

API çağrı hatalarının ne anlama geldiği ve bunların nasıl ele alınacağı hakkında bilgi için, bkz. Hata Mesajları .