Google setzt sich dafür ein, die Rassengerechtigkeit für schwarze Gemeinschaften zu fördern. Siehe wie.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Nest-API-Referenz

Die Nest-API modelliert ein physisches Haus oder Gebäude als Struktur mit Nest-Lernthermostaten, Nest-Schutzelementen und Nest-Kameras als Geräte in der Struktur. Diese Struktur enthält auch Informationen über das gesamte Haus (z. B. Abwesenheits- oder ETA-Status oder aktive Hauptverkehrszeiten).

Jedes Datenelement in der Struktur kann über eine Ressourcen-URL ("Datenpositionen" genannt) in einem gemeinsam genutzten JSON-Dokument adressiert werden. Jeder Datenspeicherort kann Zeichenfolgen, Zahlen, Boolesche Werte, übergeordnete / untergeordnete Objekte oder Arrays speichern.

Erkunden Sie das Datenmodell mit dieser interaktiven API-Referenz .

Über die API können Sie Daten von Standorten auf mehreren Ebenen im Datenmodell synchronisieren, z. B.:

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

Ihre Produkte sollten nachdenklich auf Ereignisse wie diese reagieren:

Beachten Sie jedoch, dass jedes der gerätebasierten Objekte unter realen Bedingungen arbeitet. Beispielsweise sollte der Thermostat die Klimaanlage nicht betreiben, wenn die Notheizung aktiviert ist. Unsere API wurde entwickelt, um sowohl unsere Geräte als auch das Haus 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 zum Lesen oder Schreiben an einem Datenspeicherort wird durch Berechtigungen gesteuert. Berechtigungsgruppen bieten Lese-, Schreib- oder Lese- / Schreibzugriff auf ausgewählte Datenwerte in Geräten und Strukturen.

Weitere Informationen finden Sie in der Berechtigungsübersicht .

Daten und Datenschutz

Die mit Heimprodukten verbundenen Daten 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 wichtiger Schwerpunkt bei Nest. Wir machen den Benutzern klar, welche Art von Daten wir haben, wie sie verwendet werden und wo sie sie steuern können.

Erfahren Sie mehr über unsere Ansichten zum Datenschutz .

Metadaten

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

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

Zugangstoken

Nach der Benutzerautorisierung verwendet Ihr Produkt ein Zugriffstoken, um API-Aufrufe an den Nest-Dienst zu senden. Dieses Zugriffstoken dient als Beweis 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

Die Client-Version ist die letzte vom Benutzer autorisierte Version eines Clients und ist einem 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 unterscheidet sich für jede Kombination aus Works with Nest-Produkt und Benutzer.

Wenn Benutzer 1 beispielsweise Works with Nest-Produkt A und Works with Nest-Produkt B autorisiert hat, hat Produkt A einen Benutzer- user_id Wert für Benutzer 1 und Produkt B einen anderen Benutzer- user_id Wert für Benutzer 1.

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