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.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Die Architektur der Nest-API

Über den Nest-Service

Mit Nest-Anwendungen können Benutzer von jedem Ort aus eine Verbindung zu ihrem Zuhause herstellen. Alle Nest-Geräte (Thermostate, Schutzfunktionen und Kameras) und Anwendungen (iOS-, Android- und Web-Apps) stellen eine Verbindung zum Nest-Dienst her.

Beispiel Cloud-to-Cloud

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

Beispielsweise liest ein Thermostat seine Zieltemperatur aus dem Datenmodell. Es stellt die Umgebungstemperatur auf die aktuelle Messung ein und sendet Sensordaten an den Home / Away Assist, der den Strukturmodus entsprechend anpasst.

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

Das Datenmodell

Die Nest-API wird als JSON-Dokument mit Attributen der obersten Ebene von metadata , devices und structures . Ihre Arbeiten mit Nest-Produkten 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 Organisationspunkt für devices und speichern Daten für das gesamte Gebäude. In der Regel ist eine structure ein Benutzerhaus.

Nest- devices repräsentieren physische Geräte (Thermostate, Schutzvorrichtungen und Kameras) innerhalb einer Struktur.

Jedes Datenelement im JSON-Dokument kann über eine URL adressiert werden (auch als "Datenspeicherorte" bezeichnet). Arbeiten mit Nest-Produkten können Abschnitte dieses Dokuments lesen und schreiben und Änderungen abonnieren. Mit dieser Abonnementfunktion können Works with Nest-Produkte in Echtzeit auf Änderungen am System reagieren, z. B. das Ausschalten von Lichtern, wenn ein Benutzer die Struktur auf "Abwesend" setzt.

Objekte arbeiten auch unter realen Bedingungen. 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.

Erkunden Sie das Datenmodell mit dieser interaktiven API-Referenz .

Bestimmter Zustand

Der Nest-Service speichert den autorisierenden 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 Teilnehmer.

Da diese Ausbreitung eine gewisse Verzögerung aufweist 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 der Dienstleistung beobachtet wird. Der Status wird schließlich synchronisiert, wenn Nachrichten zwischen verschiedenen Produkten übertragen werden.

Dieses dokumentenorientierte Publish / Subscribe-Modell bietet reaktionsschnelle Anwendungsinteraktionen.

Verwenden des Nest-Dienstes

Verwenden Sie HTTPS in Ihrem Produkt, um auf die REST-Endpunkte im Nest-Service zuzugreifen. Es gibt viele Client-Bibliotheken 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 vom Benutzer immer ausdrücklich erteilt. Weitere Informationen finden Sie in der Berechtigungsübersicht .

Die Autorisierung erfolgt über das OAuth 2.0-Protokoll. Wenn ein Benutzer sich bereit erklärt, Zugriff auf die angeforderte Berechtigungsstufe bereitzustellen, authentifiziert Nest die Anforderung 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 Benutzers zu interagieren.

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

Informationen zum Autorisieren einer Verbindung zur Nest-API finden Sie in der Autorisierungsübersicht .