Schéma du ventilateur

Nest Thermostat 

sdm.devices.traits.Fan

Ce trait appartient à tout appareil dont le système peut contrôler le ventilateur.

Champs

Champ Description Type de données
timerMode Mode de minuteur actuel. string
Values: "ON", "OFF"
timerTimeout Horodatage, au format RFC 3339, auquel le mode de minuteur sera désactivé. string
Example: "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

Modifiez le minuteur du ventilateur.

Requête et réponse SetTimer

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 la requête SetTimer

Champ Description Type de données
timerMode Mode de définition du minuteur du ventilateur. string
Values: "ON", "OFF"
duration Facultatif. Spécifie la durée en secondes pendant laquelle le minuteur est défini pour s'exécuter. string
Range: "1s" to "43200s"
Default: "900s"

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés en lien avec ce trait :

Message d'erreur RPC Dépannage
Le ventilateur du thermostat n'est pas disponible. FAILED_PRECONDITION Le thermostat n'est pas équipé d'un ventilateur. Les traits et commandes liés au ventilateur ne peuvent pas être utilisés pour cet appareil.

Pour obtenir la liste complète des codes d'erreur de l'API, consultez la documentation de référence sur les codes d'erreur de l'API.