Schema ventola

Termostato Nest 

sdm.devices.traits.Fan

Questo tratto appartiene a qualsiasi dispositivo che ha la capacità di sistema di controllare la ventola.

Campi

Campo Descrizione Tipo di dati
timerMode Modalità timer attuale. string
Valori: "ON", "OFF"
timerTimeout Timestamp in formato RFC 3339, in cui la modalità timer verrà 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: da "1 s" a "43.200 s"
Predefinito: "900 s"

Errori

In relazione a questa caratteristica, potrebbero essere restituiti i seguenti codici di errore:

Messaggio di errore RPC Risolvere i problemi
Ventola del termostato non disponibile. FAILED_PRECONDITION Il termostato non dispone di una funzionalità di ventola. I comandi e i tratti relativi ai fan non possono essere utilizzati per questo dispositivo.

Consulta la pagina Riferimento sui codici di errore delle API per l'elenco completo dei codici di errore delle API.