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.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Architektura interfejsu API Nest

O usłudze Nest

Aplikacje Nest umożliwiają użytkownikom łączenie się z domem z dowolnego miejsca. Wszystkie urządzenia Nest (termostaty, zabezpieczenia i kamery) oraz aplikacje (iOS, Android i aplikacje internetowe) łączą się z usługą Nest.

Przykład z chmury do chmury

Usługa Nest zapewnia model danych domu. Urządzenia i aplikacje odczytują ten model danych w celu podjęcia odpowiednich działań. Aktualizują model danych, aby odzwierciedlić zmiany w systemie.

Na przykład termostat odczytuje swoją temperaturę docelową z modelu danych. Ustawia temperaturę otoczenia na aktualny pomiar i wysyła dane z czujnika do Home / Away Assist, który odpowiednio dostosowuje tryb konstrukcji.

Urządzenia Nest działają w ograniczonych środowiskach. Moc jest ograniczona, a łączność z siecią domową może być zawodna. Twoje produkty i usługi mogą wykorzystywać nasze algorytmy urządzeń, aby oferować użytkownikom proste, intuicyjne doświadczenia domowe.

Model danych

Nest API jest reprezentowany jako dokument JSON z atrybutami najwyższego poziomu metadata , devices i structures . Produkty Works with Nest wykorzystują ten dokument JSON do interakcji i reagowania na urządzenia Nest i powiązane zmiany stanu.

structures gniazd reprezentują structures fizyczne w świecie rzeczywistym. Służą jako punkt organizacyjny dla devices i przechowują dane dla całego budynku. Zazwyczaj structure jest domem użytkownika.

devices Nest reprezentują devices fizyczne (termostaty, zabezpieczenia i kamery) w strukturze.

Każdy element danych w dokumencie JSON można adresować za pomocą adresu URL (zwanego również „lokalizacją danych”). Works z produktami Nest może czytać i zapisywać w sekcjach tego dokumentu oraz subskrybować zmiany. Ta możliwość subskrypcji umożliwia produktom Works with Nest reagowanie w czasie rzeczywistym na zmiany wprowadzone w systemie, takie jak wyłączanie świateł, gdy użytkownik przestawi strukturę w tryb Away.

Obiekty działają również w warunkach rzeczywistych. Model danych chroni urządzenia i dom użytkownika, zapobiegając zaskakującym i niebezpiecznym działaniom. Na przykład termostat nie uruchamia klimatyzatora, gdy włączone jest ogrzewanie awaryjne.

Eksploruj model danych za pomocą tego interaktywnego interfejsu API .

Stan zamierzony

Usługa Nest przechowuje autorytatywny stan systemu i subskrybuje zmiany w produktach Works with Nest. Modyfikacja tego stanu (na przykład zmiana temperatury docelowej termostatu) powoduje, że usługa wysyła powiadomienie o zmianie do wszystkich abonentów.

Ponieważ propagacja ta ma pewne opóźnienia, a sieci mogą być zawodne, stan obserwowany przez produkt może nie być stanem obserwowanym obecnie przez inne produkty lub usługę. Stan jest ostatecznie synchronizowany, gdy komunikaty są przesyłane między różnymi produktami.

Ten zorientowany na dokumenty model publikowania / subskrypcji zapewnia responsywne interakcje aplikacji.

Korzystanie z usługi Nest

Aby uzyskać dostęp do punktów końcowych REST w usłudze Nest, użyj protokołu HTTPS w swoim produkcie. Istnieje wiele bibliotek klienckich innych firm, których można użyć w tym celu.

Uprawnienia i autoryzacja

Chcemy umożliwić programistom tworzenie produktów i usług, które ulepszają domy, bez narażania prywatności i bezpieczeństwa użytkowników. Cała nasza komunikacja jest bezpieczna, a pozwolenie na dostęp do danych jest zawsze wyraźnie udzielane przez użytkownika. Aby uzyskać więcej informacji, zobacz Omówienie uprawnień .

Autoryzacja jest obsługiwana przez protokół OAuth 2.0. Gdy użytkownik zgadza się zapewnić dostęp do żądanego poziomu uprawnień, Nest uwierzytelnia żądanie i żądającemu zostaje przyznany token dostępu. Ten token dostępu może być używany do uzyskiwania dostępu do Nest API i interakcji ze strukturami i urządzeniami użytkownika.

Przyznanie tokenu dostępu ustanawia relację zaufania między użytkownikiem, produktem Works with Nest i Nest. Użytkownicy mogą w każdej chwili odwołać dostęp.

Aby dowiedzieć się, jak autoryzować połączenie z Nest API, zobacz Omówienie autoryzacji .