Un trait nell'API SDM comprende campi, comandi ed eventi.
Campi
I campi sono valori con tipi di dati comuni, come un numero o una stringa. Ad esempio, un campo
potrebbe contenere la modalità corrente o l'umidità ambientale di Google Nest Thermostat.
I trait e i campi possono essere visualizzati con una chiamata GET all'endpoint API desiderato:
L'elemento sdm.devices.types.device-type restituito dall'API SDM non deve essere utilizzato
per dedurre o dedurre la funzionalità del dispositivo effettivo a cui è assegnata. Non vi è alcuna garanzia
che un tipo di dispositivo rimanga stabile per un dispositivo specifico man mano che vengono aggiunte altre funzionalità a SDM.
tramite Google Cloud CLI
o tramite l'API Compute Engine. Utilizza invece i trait restituiti per il dispositivo.
parentRelations
L'oggetto parentRelations rappresenta la risorsa padre della risorsa attuale,
o una struttura o una stanza. Il nome visualizzato corrisponde al campo customName della
Informazioni sulla camera
per i dispositivi con una struttura principale
Trait RoomInfo per i dispositivi con
genitore della stanza.
Comandi
I comandi sono richieste associate a un tratto. Ad esempio, la modifica della modalità corrente o
set-point di temperatura su Google Nest Thermostat.
Un comando viene inviato da una chiamata API executeCommand:
La maggior parte delle risposte a un comando sono semplici operazioni riuscite o non riuscite. Consulta le guide sulle trait individuali
esempi di utilizzo dei comandi specifici.
Eventi
Gli eventi sono asincroni e gestiti da Google Cloud Pub/Sub in un unico argomento
Project ID.
Per impostazione predefinita, vengono inviati eventi per qualsiasi modifica al valore di un campo dei tratti. Possono anche essere inviati
risposta ad azioni specifiche dei dispositivi o modifiche nelle assegnazioni delle risorse. Consulta
Eventi
per ulteriori informazioni.
Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura ottimale.