Schema della ventola

Termostato Nest 

sdm.devices.traits.Fan

Questo tratto appartiene a qualsiasi dispositivo in grado di controllare la ventola.

Campi

Campo Descrizione Tipo di dati
timerMode Modalità timer attuale. string
Valori: "ON", "OFF"
timerTimeout Timestamp, nel formato RFC 3339, relativo al quale la modalità timer viene disattivata. string
Esempio: "2019-05-10T03:22:54Z"

Esempio di richiesta e risposta GET

Richiesta

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

Risposta

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

Comandi

SetTimer

Modifica il timer della ventola.

Richiesta e risposta SetTimer

Richiesta

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

Risposta

{}

Campi di richiesta SetTimer

Campo Descrizione Tipo di dati
timerMode La modalità per impostare il timer della ventola. string
Valori: "ON", "OFF"
duration Facoltativo. Specifica la durata in secondi dell'esecuzione del timer. string
Intervallo: "1 s" su "43200s"
Predefinito: "900s"

Errori

Potrebbero essere restituiti i seguenti codici di errore in relazione a questo tratto:

Messaggio di errore RPC Risoluzione dei problemi
Ventola del termostato non disponibile. FAILED_PRECONDITION Il termostato non ha una funzionalità di ventola. Per questo dispositivo non è possibile utilizzare i tratti e i comandi relativi ai fan.

Consulta la documentazione sul codice di errore API per l'elenco completo dei codici di errore dell'API.