Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Eine Eigenschaft in der SDM API besteht aus Feldern, Befehlen und Ereignissen.
Felder
Felder sind Werte mit gängigen Datentypen, z. B. Zahlen oder Strings. Ein Feld kann beispielsweise den aktuellen Modus oder die Luftfeuchtigkeit eines Google Nest Thermostats enthalten.
Attribute und Felder können mit einem GET-Aufruf an den gewünschten API-Endpunkt aufgerufen werden:
Die von der SDM API zurückgegebene sdm.devices.types.device-type sollte nicht verwendet werden, um die Funktionen des tatsächlichen Geräts abzuleiten oder abzuleiten, dem sie zugewiesen ist. Es gibt keine Garantie, dass ein Gerätetyp für ein bestimmtes Gerät stabil bleibt, wenn der SDM API weitere Features hinzugefügt werden. Verwenden Sie stattdessen die zurückgegebenen Eigenschaften für das Gerät.
übergeordnete Beziehungen
Das Objekt parentRelations stellt die übergeordnete Ressource der aktuellen Ressource dar, entweder eine Struktur oder einen Raum. Der Anzeigename entspricht dem Feld customName derInfo Merkmal für Geräte mit einem Übergeordneten Element oder der EigenschaftRoomInfo {20/room].
Befehle
Befehle sind Anfragen, die mit einem Merkmal verknüpft sind. Beispielsweise können Sie den aktuellen Modus oder Temperatursollwert eines Google Nest Thermostats ändern.
Ein Befehl wird von einem executeCommand-API-Aufruf gesendet:
Die meisten Antworten auf einen Befehl sind ein einfacher Erfolg. Beispiele für die Verwendung von Befehlen finden Sie in den jeweiligen Trait-Guides.
Veranstaltungen
Ereignisse sind asynchron und werden von Google Cloud Pub/Sub in einem einzigen Thema pro Project -ID verwaltet.
Ereignisse werden standardmäßig gesendet, wenn sich der Wert eines Eigenschaftsfelds ändert. Sie können auch als Reaktion auf bestimmte Geräteaktionen oder Änderungen bei Ressourcenzuweisungen gesendet werden. Weitere Informationen finden Sie unter Ereignisse.