Schéma de fan

Nest Thermostat 

sdm.devices.traits.Fan

Cette caractéristique appartient à tout appareil capable de contrôler le ventilateur.

Champs

Champ Description Type de données
timerMode Mode du minuteur actuel. string
Valeurs : "ON", "OFF"
timerTimeout Code temporel, au format RFC 3339, d'expiration du moment où le mode minuteur est désactivé. string
Exemple : "2019-05-10T03:22:54Z"

Exemple de requête GET et de réponse

Requête

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

Réponse

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

Commandes

SetTimer

Modifier le minuteur du ventilateur.

Requête SetTimer et réponse

Requête

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

Réponse

{}

Champs de requête SetTimer

Champ Description Type de données
timerMode Mode de réglage du minuteur du ventilateur. string
Valeurs : "ON", "OFF"
duration Facultatif. Spécifie la durée d'exécution du minuteur, en secondes. string
Plage : "1 s" à "43200s"
Par défaut : "900s"

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés pour cette caractéristique:

Message d'erreur RPC Dépannage
Ventilateur du thermostat indisponible. FAILED_PRECONDITION Le thermostat n'est pas équipé d'un ventilateur. Impossible d'utiliser les fonctionnalités et commandes liées aux fans sur cet appareil.

Consultez la documentation de référence sur les codes d'erreur de l'API pour la liste complète des codes d'erreur de l'API.