Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Dans l'API SDM, un trait comprend des champs, des commandes et des événements.
Champs
Les champs sont des valeurs avec des types de données courants, comme un nombre ou une chaîne. Par exemple, un champ peut contenir le mode actuel ou l'humidité ambiante d'un thermostat Google Nest.
Les traits et les champs peuvent être consultés avec un appel GET au point de terminaison de l'API souhaité :
Le sdm.devices.types.device-type renvoyé par l'API SDM ne doit pas être utilisé pour déduire ou inférer les fonctionnalités de l'appareil auquel il est attribué. Il n'est pas garanti qu'un type d'appareil reste stable pour un appareil spécifique à mesure que des fonctionnalités sont ajoutées à l'API SDM. Utilisez plutôt les traits renvoyés pour l'appareil.
parentRelations
L'objet parentRelations représente la ressource parente de la ressource actuelle, qu'il s'agisse d'une structure ou d'une pièce. Le nom à afficher correspond au champ customName deInfo trait pour les appareils avec une structure parente ou àRoomInfo trait pour les appareils avec une pièce parente.
Commandes
Les commandes sont des requêtes associées à un trait. Par exemple, en modifiant le mode actuel ou la température de consigne sur un thermostat Google Nest.
Une commande est envoyée par un appel d'API executeCommand :
La plupart des réponses à une commande sont une simple réussite ou un simple échec. Consultez les guides de traits individuels pour obtenir des exemples d'utilisation de commandes spécifiques.
Événements
Les événements sont asynchrones et gérés par Google Cloud Pub/Sub dans un seul sujet par ID Project .
Les événements sont envoyés par défaut pour toute modification de la valeur d'un champ de caractéristique. Elles peuvent également être envoyées en réponse à des actions spécifiques de l'appareil ou à des modifications dans les attributions de ressources. Pour en savoir plus, consultez Événements.
Ce trait appartient à tout appareil compatible avec une sonnerie de porte et les événements de pression associés.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/29 (UTC).
[null,null,["Dernière mise à jour le 2025/07/29 (UTC)."],[[["\u003cp\u003eThe Smart Device Management API allows you to interact with Nest devices through traits, commands, and events.\u003c/p\u003e\n"],["\u003cp\u003eTraits represent device capabilities and their associated data, such as temperature or humidity, and are categorized by device type like Thermostat or Camera.\u003c/p\u003e\n"],["\u003cp\u003eCommands are used to control devices, for instance, changing the thermostat mode, while events provide asynchronous notifications about device state changes.\u003c/p\u003e\n"],["\u003cp\u003eYou can access device information and traits through a GET request to the specified API endpoint using the device ID.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud Pub/Sub manages events and delivers them to a dedicated topic for each project ID, allowing you to stay updated on device activity.\u003c/p\u003e\n"]]],[],null,[]]
