Google is committed to advancing racial equity for Black communities. See how.

Die Architektur der Nest API

Über den Nest-Dienst

Nest-Anwendungen ermöglichen es Nutzern, sich von überall aus mit ihrem Zuhause zu verbinden. Alle Nest-Geräte (Thermostate, Protects und Kameras) und Anwendungen (iOS, Android und Web-Apps) verbinden sich mit dem Nest-Dienst.

Beispiel Cloud-to-Cloud

Der Nest-Dienst stellt ein Datenmodell des Zuhauses bereit. Geräte und Anwendungen lesen aus diesem Datenmodell, um geeignete Maßnahmen zu ergreifen. Sie aktualisieren das Datenmodell, um Änderungen im System widerzuspiegeln.

Ein Thermostat liest beispielsweise seine Solltemperatur aus dem Datenmodell. Er stellt die Umgebungstemperatur auf seinen aktuellen Messwert ein und sendet Sensordaten an den Zuhause/Abwesend-Assistent, der den Strukturmodus entsprechend anpasst.

Nest-Geräte arbeiten in eingeschränkten Umgebungen. Die Stromversorgung ist begrenzt und die Heimnetzwerkkonnektivität kann unzuverlässig sein. Ihre Produkte und Dienstleistungen können unsere Gerätealgorithmen nutzen, um Benutzern ein einfaches, intuitives Heimerlebnis zu bieten.

Das Datenmodell

Das Nest API ist als JSON Dokument mit Top-Level - Attributen dargestellt metadata , devices und structures . Ihre Works with Nest-Produkte verwenden dieses JSON-Dokument, um mit Nest-Geräten und zugehörigen Statusänderungen zu interagieren und darauf zu reagieren.

Nest structures repräsentieren physikalische Strukturen in der realen Welt. Sie dienen als Ordnungspunkt für devices und Speichern von Daten für das Gebäude als Ganzes. Typischerweise wird eine structure ist ein Benutzer zu Hause.

Nest devices repräsentieren physikalische Geräte (Thermostate, schützt und Kameras) innerhalb einer Struktur.

Jedes Datenelement im JSON-Dokument ist über eine URL (auch als "Datenspeicherorte" bezeichnet) adressierbar. Works with Nest-Produkte können Abschnitte dieses Dokuments lesen und schreiben sowie Änderungen abonnieren. Dank dieser Abonnementfunktion können Works with Nest-Produkte in Echtzeit auf Änderungen am System reagieren, z.

Objekte funktionieren auch unter realen Einschränkungen. Das Datenmodell schützt Geräte und das Zuhause des Benutzers, indem es überraschende und gefährliche Aktionen verhindert. Beispielsweise lässt der Thermostat die Klimaanlage nicht laufen, wenn die Notheizung aktiviert ist.

Entdecken Sie das Datenmodell mit dieser interaktiven API - Referenz .

Vorgesehener Zustand

Der Nest-Dienst speichert den maßgeblichen Status des Systems und Works with Nest-Produkte abonnieren Änderungen. Wenn Sie diesen Status ändern (z. B. um die Zieltemperatur eines Thermostats zu ändern), sendet der Dienst eine Änderungsbenachrichtigung an alle Abonnenten.

Da diese Verbreitung eine gewisse Verzögerung hat und Netzwerke unzuverlässig sein können, ist der von einem Produkt beobachtete Zustand möglicherweise nicht der Zustand, der derzeit von anderen Produkten oder dem Dienst beobachtet wird. Der Zustand wird schließlich synchronisiert, wenn Nachrichten zwischen verschiedenen Produkten übertragen werden.

Dieses dokumentorientierte Publish/Subscribe-Modell bietet reaktionsschnelle Anwendungsinteraktionen.

Den Nest-Dienst verwenden

Verwenden Sie HTTPS in Ihrem Produkt, um auf die REST-Endpunkte im Nest-Dienst zuzugreifen. Es gibt viele Clientbibliotheken von Drittanbietern, die für diesen Zweck verwendet werden können.

Berechtigungen und Autorisierung

Wir möchten Entwicklern ermöglichen, Produkte und Dienstleistungen zu entwickeln, die das Zuhause verbessern, ohne die Privatsphäre und Sicherheit der Benutzer zu beeinträchtigen. Alle unsere Kommunikationen sind sicher und die Erlaubnis zum Zugriff auf Daten wird immer ausdrücklich vom Benutzer erteilt. Weitere Informationen finden Sie im siehe Berechtigungen Übersicht .

Die Autorisierung erfolgt über das OAuth 2.0-Protokoll. Wenn ein Benutzer zustimmt, Zugriff auf die angeforderte Berechtigungsstufe zu gewähren, authentifiziert Nest die Anfrage und dem Anforderer wird ein Zugriffstoken gewährt. Dieses Zugriffstoken kann verwendet werden, um auf die Nest API zuzugreifen und mit den Strukturen und Geräten des Nutzers zu interagieren.

Durch die Gewährung eines Zugriffstokens wird eine Vertrauensbeziehung zwischen einem Nutzer, einem Works with Nest-Produkt und Nest hergestellt. Benutzer können den Zugriff jederzeit widerrufen.

Um zu erfahren , wie eine Verbindung mit dem Nest API autorisieren, finden Sie in der Autorisierungs - Übersicht .