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 Mimarisi

Nest hizmeti hakkında

Nest uygulamaları, kullanıcıların nerede olurlarsa olsunlar evlerine bağlanmalarına olanak tanır. Tüm Nest cihazları (Termostatlar, Korumalar 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. Uygun eylemi gerçekleştirmek için bu veri modelini okuyan cihazlar ve uygulamalar. Sistemdeki değişiklikleri yansıtmak için veri modelini 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 Home / Away Assist'e gönderir.

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

Veri modeli

Nest API, metadata , devices ve structures üst düzey özellikleriyle bir JSON belgesi olarak temsil edilir. Works 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 bir bütün olarak bina için verileri depolarlar. Tipik olarak, bir structure bir kullanıcı evidir.

Nest devices , bir yapı içindeki fiziksel cihazları (Termostatlar, Korumalar ve Kameralar) temsil eder.

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

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

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

Amaçlanan durum

Nest hizmeti, sistemin yetkili durumunu depolar ve Works with Nest ürünleri değişikliklere abone olur. Bu durumun değiştirilmesi (örneğin, bir termostatın hedef sıcaklığının değiştirilmesi), hizmetin tüm abonelere bir değişiklik bildirimi göndermesine neden olur.

Bu yayılmanın biraz gecikmesi olduğundan ve ağlar 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 iletilirken sonunda senkronize edilir.

Bu belge odaklı 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ı gizliliği ve güvenliğinden ödün vermeden evleri daha iyi hale getiren ürün ve hizmetler geliştirmelerine 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ğin kimliğini doğrular ve istekte bulunan kişiye bir erişim belirteci verilir. Bu erişim jetonu, Nest API'ye erişmek ve kullanıcının yapıları ve cihazlarıyla etkileşim kurmak için kullanılabilir.

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

Nest API ile bir bağlantının nasıl yetkilendirileceğini öğrenmek için Yetkilendirmeye Genel Bakış konusuna bakın.