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

Nest API-Referenz

Die Nest API modelliert ein physisches Zuhause oder Gebäude als Struktur mit Nest Learning Thermostats, Nest Protects und Nest Cams als Geräte in der Struktur. Diese Struktur enthält auch Informationen über das Zuhause als Ganzes (z. B. Abwesenheits- oder ETA-Status oder aktive Stoßzeiten).

Jedes Datenelement in der Struktur ist über eine Ressourcen-URL (als "Datenspeicherorte" bezeichnet) in einem freigegebenen JSON-Dokument adressierbar. Jeder Datenspeicherort kann Zeichenfolgen, Zahlen, Boolesche Werte, übergeordnete/untergeordnete Objekte oder Arrays speichern.

Entdecken Sie das Datenmodell mit dieser interaktiven API - Referenz .

Über die API können Sie Daten von Standorten auf mehreren Ebenen im Datenmodell synchronisieren, zum Beispiel:

  • eine ganze Struktur, einschließlich aller Geräte
  • ein einzelnes Gerät in einer Struktur
  • eine Gruppe von Datenwerten (aktuelle und Umgebungstemperatur)
  • ein einzelner Datenwert (Batteriezustand)

Ihre Produkte sollten nachdenklich auf Ereignisse wie diese reagieren:

Beachten Sie jedoch, dass jedes der gerätebasierten Objekte unter realen Einschränkungen funktioniert. Zum Beispiel sollte der Thermostat die Klimaanlage nicht laufen lassen, wenn die Notheizung aktiviert ist. Unsere API wurde entwickelt, um sowohl unsere Geräte als auch das Zuhause des Benutzers zu schützen und bestimmte Aktionen zu verhindern, wenn sie überraschend oder gefährlich wären.

Berechtigungen und freigegebene Gerätedaten

Die Fähigkeit, einen Datenspeicherort zu lesen oder zu schreiben, wird durch Berechtigungen gesteuert. Berechtigungsgruppen bieten Lese-, Schreib- oder Lese-/Schreibzugriff auf ausgewählte Datenwerte in Geräten und Strukturen.

Für mehr Informationen, die sehen Berechtigungen Übersicht .

Daten und Privatsphäre

Die Daten zu Haushaltsprodukten können sehr persönlich sein. Heimsensordaten enthalten Informationen darüber, wie Menschen ihr Leben in ihrem persönlichen Bereich leben. Die Sicherheit und der Umgang mit diesen Daten sind sehr wichtig und ein wesentlicher Schwerpunkt bei Nest. Wir machen den Benutzern klar, welche Art von Daten wir haben, wie sie verwendet werden und wo sie sie kontrollieren können.

Erfahren Sie mehr über unsere Ansichten über die Privatsphäre .

Metadaten

Metadaten sind zusätzliche Informationen, die bereitgestellt werden, wenn Sie den Endpunkt auf Stammebene aufrufen:

https://developer-api.nest.com/

Zugangstoken

Nach der Nutzerautorisierung verwendet Ihr Produkt ein Zugriffstoken, um API-Aufrufe an den Nest-Dienst zu senden. Dieses Zugriffstoken dient als Nachweis dafür, dass ein Benutzer Ihr Produkt autorisiert hat, in seinem Namen Anrufe zu tätigen.

Einzelheiten
Kehrt zurück string
Beispiel: "c.FmDPkzyzaQe..."

client_version

Client - Version ist die letzte Benutzer autorisierte Version eines Kunden, und ist mit einem zugehörigen access_token .

Wenn Sie die Berechtigungen für einen Client aktualisieren, wird die Clientversion erhöht und der Benutzer wird benachrichtigt, dass ein Update verfügbar ist. Ihre Benutzer müssen dieses Client-Update akzeptieren, bevor sie Ihr aktualisiertes Produkt verwenden können.

Einzelheiten
Kehrt zurück number
Beispiele: 1, 17, 42

Benutzeridentifikation

Mit der Benutzer-ID können Sie Benutzer über API-Aufrufe hinweg identifizieren. Diese Kennung ist für jede Works with Nest-Produkt- und Nutzerkombination unterschiedlich.

Nest mit Produkt A und Works Wenn beispielsweise 1 Anwender arbeitet mit Nest Produkt B autorisiert hat, dann hat das Produkt A einen user_id Wert für Benutzer 1, und Produkt B , einen anderen hat user_id Wert für Benutzer 1.

Einzelheiten
Kehrt zurück string
Beispiel: z.1.1.7DHps...