Ein Trait in der SDM API umfasst Felder, Befehle und Ereignisse.
Felder
Felder sind Werte mit gängigen Datentypen, z. B. eine Zahl oder ein String. Beispiel: Ein Feld
kann der aktuelle Modus oder die Luftfeuchtigkeit eines Google Nest Thermostats enthalten.
Merkmale und Felder können mit einem GET-Aufruf an den gewünschten API-Endpunkt angezeigt werden:
Das von der SDM API zurückgegebene sdm.devices.types.device-type sollte nicht verwendet werden
um die Funktionalität des Geräts abzuleiten oder abzuleiten, dem es zugewiesen ist. Es gibt keine Garantie
dass ein Gerätetyp für ein bestimmtes Gerät stabil bleibt, wenn dem SDM weitere Funktionen hinzugefügt werden.
der API erstellen. Verwende stattdessen die zurückgegebenen Traits für das Gerät.
parentRelations
Das Objekt parentRelations stellt die übergeordnete Ressource der aktuellen Ressource dar.
entweder ein Gebäude oder einen Raum. Der Anzeigename entspricht dem Feld customName der
Info-Trait
für Geräte mit übergeordnetem Gebäude oder der
RoomInfo-Trait für Geräte mit einem
übergeordnetes Element des Chatrooms.
Befehle
Befehle sind Anfragen, die mit einem Merkmal verknüpft sind. Wenn Sie z. B. den aktuellen Modus oder
Temperatursollwert an einem Google Nest Thermostat.
Ein Befehl wird von einem executeCommand-API-Aufruf gesendet:
Die meisten Antworten auf einen Befehl sind einfach erfolgreich oder nicht erfolgreich. In den Leitfäden zu den einzelnen Traits findest du
spezifische Beispiele für die Verwendung von Befehlen.
Ereignisse
Ereignisse sind asynchron und werden von Google Cloud Pub/Sub in einem einzigen Thema pro
Project ID.
Ereignisse werden standardmäßig bei jeder Änderung am Wert eines Trait-Felds gesendet. Sie können auch per E-Mail
auf bestimmte Geräteaktionen oder Änderungen bei Ressourcenzuweisungen reagieren. Weitere Informationen finden Sie unter
Veranstaltungen
.