Schema für Lüfter

Nest Thermostat 

sdm.devices.traits.Fan

Dieses Merkmal gehört zu allen Geräten, die das System zur Steuerung des Lüfters haben.

Felder

Feld Beschreibung Datentyp
timerMode Aktueller Timer-Modus. string
Werte: „ON“, „OFF“
timerTimeout Zeitstempel im RFC 3339-Format, zu dem der Timer-Modus auf „AUS“ gestellt wird. string
Beispiel: „2019-05-10T03:22:54Z“

Beispiel für GET-Anfrage und -Antwort

Anfrage

GET /enterprises/project-id/devices/device-id

Antwort

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

Befehle

SetTimer

Timer für Lüfter ändern

„SetTimer“-Anfrage und -Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

Antwort

{}

Felder der SetTimer-Anfrage

Feld Beschreibung Datentyp
timerMode Der Modus zum Einstellen des Lüfter-Timers. string
Werte: „ON“, „OFF“
duration Optional. Gibt die Zeit in Sekunden an, für die der Timer eingestellt ist. string
Bereich: „1s“ bis „43200s“
Standard: „900s“

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Attribut zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Der Thermostatlüfter ist nicht verfügbar. FAILED_PRECONDITION Der Thermostat hat keine Lüfterfunktion. Fanbezogene Attribute und Befehle können für dieses Gerät nicht verwendet werden.

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.