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

Nest API Referansı

Nest API, yapıdaki cihazlar olarak Nest Learning Termostatlar, Nest Protects ve Nest Cams ile fiziksel bir ev veya binayı bir yapı olarak modeller. Bu yapı aynı zamanda bir bütün olarak ev hakkında bilgi içerir (Uzakta veya ETA durumu veya aktif Çalışma Saatleri gibi).

Yapıdaki her veri öğesi, paylaşılan bir JSON belgesindeki bir kaynak URL'si ("veri konumları" olarak adlandırılır) ile adreslenebilir. Her veri konumu, dizeleri, sayıları, booleları, üst / alt nesneleri veya dizileri depolayabilir.

Bu etkileşimli API Başvurusu ile veri modelini keşfedin.

API'dan, veri modelinde birden çok düzeydeki konumlardan verileri senkronize edebilirsiniz, örneğin:

  • tüm cihazlar dahil tüm yapı
  • bir yapıdaki tek bir cihaz
  • bir grup veri değeri (mevcut ve ortam sıcaklığı)
  • tek bir veri değeri (pil sağlığı durumu)

Ürünleriniz aşağıdaki gibi olaylara dikkatle yanıt vermelidir:

Ancak, cihaz tabanlı nesnelerin her birinin gerçek dünya kısıtlamaları altında çalıştığını unutmayın. Örneğin, acil durum ısısı etkinleştirildiğinde termostat klimayı çalıştırmamalıdır. API'miz hem cihazlarımızı hem de kullanıcının evini korumak için tasarlanmıştır ve şaşırtıcı veya tehlikeli olmaları durumunda belirli işlemleri önleyecektir.

İzinler ve paylaşılan cihaz verileri

Bir veri konumunu okuma veya bu konuma yazma yeteneği izinlerle kontrol edilir. İzin grupları, aygıtlarda ve yapılarda seçilen veri değerlerine okuma, yazma veya okuma / yazma erişimi sağlar.

Daha fazla bilgi için İzinlere Genel Bakış konusuna bakın.

Veri ve gizlilik

Ev ürünleri ile ilgili veriler çok kişisel olabilir. Ev sensörü verileri, insanların yaşamlarını kişisel alanlarında nasıl yaşadıkları hakkında bilgiler içerir. Bu verilerin güvenliği ve işlenmesi çok önemlidir ve Nest'te önemli bir odak noktası vardır. Ne tür verilere sahip olduğumuzu, nasıl kullanıldığını ve nerede kontrol edebileceklerini kullanıcılara netleştiririz.

Gizlilik hakkındaki görüşlerimiz hakkında daha fazla bilgi edinin.

Meta veri

Meta veriler, kök düzeyi uç noktasına bir çağrı yaptığınızda sağlanan ek bilgilerdir:

https://developer-api.nest.com/

ACCESS_TOKEN

Kullanıcı yetkilendirmesinden sonra, ürününüz Nest hizmetine API çağrıları yapmak için bir erişim belirteci kullanır. Bu erişim belirteci, bir kullanıcının ürününüzü kendi adına arama yapmaya yetkili kıldığının kanıtıdır.

ayrıntılar
İadeler string
Örnek: "c.FmDPkzyzaQe ..."

client_version

İstemci sürümü, istemcinin son kullanıcı tarafından yetkilendirilmiş sürümüdür ve access_token ile ilişkilendirilir.

Bir istemcinin izinlerini güncelleştirdiğinizde, istemci sürümü artırılır ve kullanıcıya bir güncelleştirmenin kullanılabilir olduğu bildirilir. Güncellenmiş ürününüzü kullanmadan önce kullanıcılarınızın bu istemci güncellemesini kabul etmesi gerekir.

ayrıntılar
İadeler number
Örnekler: 1, 17, 42

Kullanıcı kimliği

Kullanıcı kimliği, API çağrılarındaki kullanıcıları tanımlamanıza olanak tanır. Bu tanımlayıcı, her Works ile Nest ürünü ve kullanıcı birleşimi için farklılık gösterir.

Örneğin, kullanıcı 1 Nest ürünü A ile Çalışır ve Nest ürünü B ile çalışırsa, A ürününün 1 kullanıcısı için bir user_id değeri vardır ve B ürününün 1 kullanıcısı için farklı bir user_id değeri vardır.

ayrıntılar
İadeler string
Örnek: z.1.1.7DHps ...