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'sinin Mimarisi

Nest hizmeti hakkında

Nest uygulamaları kullanıcıların nerede olurlarsa olsunlar evlerine bağlanabilmelerini sağlar. Tüm Nest cihazları (Termostatlar, Korur ve Kameralar) ve uygulamalar (iOS, Android ve web uygulamaları) Nest hizmetine bağlanır.

Buluttan buluta örnek

Nest hizmeti, evin bir veri modelini sağlar. Cihazlar ve uygulamalar uygun eylemi gerçekleştirmek için bu veri modelinden okunur. Veri modelini sistemdeki değişiklikleri yansıtacak şekilde güncellerler.

Örneğin, bir termostat hedef sıcaklığını veri modelinden okur. Ortam sıcaklığını mevcut ölçümüne ayarlar ve sensör verilerini yapı modunu buna göre ayarlayan Ev / Deplasman Yardımı'na gönderir.

Nest cihazları kısıtlı ortamlarda çalışır. Güç sınırlıdır ve ev ağı bağlantısı güvenilir olmayabilir. Ürünleriniz ve hizmetleriniz, kullanıcılara basit ve sezgisel bir ev deneyimi sunmak için cihaz algoritmalarımızdan yararlanabilir.

Veri modeli

Nest API en üst düzey özelliklere sahip bir JSON belgesi olarak temsil edilir metadata , devices ve structures . Nest with Nest ürünleriniz, Nest cihazları ve ilgili durum değişiklikleriyle etkileşim kurmak ve bunlara tepki vermek için bu JSON belgesini kullanır.

Yuva structures gerçek dünyadaki fiziksel structures temsil eder. devices için bir düzenleme noktası görevi görürler ve bina için bir bütün olarak veri depolarlar. Tipik olarak, bir structure bir kullanıcı ana sayfasıdır.

Yuva devices , bir yapı içindeki fiziksel aygıtları (Termostatlar, Korur ve Kameralar) temsil eder.

JSON belgesindeki her veri öğesi URL ile adreslenebilir ("veri konumları" olarak da bilinir). Nest ürünleriyle çalışır, bu belgenin bölümlerini okuyabilir ve bu bölümlere yazabilir ve değişikliklere abone olabilir. Bu abonelik özelliği, Works ile Nest ürünlerinin, kullanıcı yapıyı Away'e ayarladığında ışıkları kapatmak gibi sistemde yapılan değişikliklere gerçek zamanlı olarak tepki vermesini sağlar.

Nesneler gerçek dünyadaki kısıtlamalar altında da çalışır. Veri modeli, şaşırtıcı ve tehlikeli eylemleri önleyerek cihazları ve kullanıcının evini korur. Örneğin, acil durum ısısı etkinleştirildiğinde termostat klimayı çalıştırmaz.

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

Öngörülen durum

Nest hizmeti, sistemin yetkili durumunu depolar ve Nest ile Çalışır ürünleri değişikliklere abone olur. Bu durumu değiştirmek (örneğin, bir termostatın hedef sıcaklığını değiştirmek için) servisin tüm abonelere bir değişiklik bildirimi göndermesine neden olur.

Bu yayılmanın bir miktar gecikmesi olduğundan ve ağların güvenilmez olabileceğinden, bir ürün tarafından gözlemlenen durum, şu anda diğer ürünler veya hizmet tarafından gözlemlenen durum olmayabilir. Durum, mesajlar çeşitli ürünler arasında iletildikçe sonunda senkronize edilir.

Bu belge yönelimli yayınlama / abone olma modeli, duyarlı uygulama etkileşimleri sağlar.

Nest hizmetini kullanma

Nest hizmetindeki REST uç noktalarına erişmek için ürününüzde HTTPS kullanın. Bu amaçla kullanılabilecek birçok üçüncü taraf istemci kitaplığı vardır.

İzinler ve yetkilendirme

Geliştiricilerin, kullanıcıların gizliliğinden ve güvenliğinden ödün vermeden evleri daha iyi hale getiren ürünler ve hizmetler oluşturmalarına izin vermek istiyoruz. Tüm iletişimlerimiz güvenlidir ve verilere erişim izni her zaman kullanıcı tarafından açıkça verilir. Daha fazla bilgi için İzinlere Genel Bakış konusuna bakın.

Yetkilendirme, OAuth 2.0 protokolü tarafından gerçekleştirilir. Bir kullanıcı istenen izin düzeyine erişim sağlamayı kabul ettiğinde, Nest isteği doğrular ve istekte bulunan kişiye erişim belirteci verilir. Bu erişim belirteci, Nest API'sine erişmek ve kullanıcının yapıları ve cihazlarıyla etkileşim kurmak için kullanılabilir.

Bir erişim belirteci vermek, bir kullanıcı, Nest ile Works ürünü ve Nest arasında bir güven ilişkisi kurar. Kullanıcılar erişimi istedikleri zaman iptal edebilir.

Nest API'sine bağlantıyı nasıl yetkilendireceğinizi öğrenmek için Yetkilendirmeye Genel Bakış konusuna bakın.