Tratti

Un trait nell'API SDM comprende campi, comandi ed eventi.

Tutte le chiamate all'API SDM devono utilizzare quanto segue endpoint:
https://smartdevicemanagement.googleapis.com/v1

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:

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

Tipi di dispositivo

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:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

La maggior parte delle risposte a un comando sono semplici operazioni riuscite o non riuscite. Consulta le guide sulle trait individuali esempi di utilizzo di 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.

Categorie di tratti

Struttura

Tratti
Informazioni	sdm.structures.traits.Info Questo tratto appartiene a qualsiasi struttura di informazioni relative alla struttura.
RoomInfo	sdm.structures.traits.RoomInfo Questo tratto appartiene a qualsiasi stanza per le informazioni relative alla stanza.

Dispositivo

Tratti
Connettività	sdm.devices.traits.Connectivity Questo tratto appartiene a qualsiasi dispositivo con informazioni di connettività.
Fan	sdm.devices.traits.Fan Questo tratto appartiene a qualsiasi dispositivo in grado di controllare la ventola.
Umidità	sdm.devices.traits.Humidity Questa caratteristica appartiene a qualsiasi dispositivo dotato di un sensore per misurare l'umidità.
Informazioni	sdm.devices.traits.Info Questo tratto appartiene a qualsiasi dispositivo per le informazioni relative a tale dispositivo.
Impostazioni	sdm.devices.traits.Settings Questo tratto appartiene a qualsiasi dispositivo per le informazioni relative alle impostazioni relative al dispositivo.
Temperatura	sdm.devices.traits.Temperature Questa caratteristica appartiene a qualsiasi dispositivo dotato di un sensore per misurare la temperatura.

Termostato

Tratti
ThermostatEco	sdm.devices.traits.ThermostatEco Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano le modalità ECO.
ThermostatHvac	sdm.devices.traits.ThermostatHvac Questo tratto appartiene ai tipi di dispositivi TERMOSTAT in grado di segnalare i dettagli dell'impianto di climatizzazione.
ThermostatMode	sdm.devices.traits.ThermostatMode Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano diverse modalità del termostato.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura ottimale.

Fotocamera

Tratti
CameraClipPreview	sdm.devices.traits.CameraClipPreview Questo tratto appartiene a qualsiasi dispositivo che supporta il download di un'anteprima dei clip.
CameraEventImage	sdm.devices.traits.CameraEventImage Questo tratto appartiene a qualsiasi dispositivo che supporta la generazione di immagini da eventi.
CameraImage	sdm.devices.traits.CameraImage Questo tratto appartiene a qualsiasi dispositivo che supporta lo scatto di immagini.
CameraLiveStream	sdm.devices.traits.CameraLiveStream Questo tratto appartiene a qualsiasi dispositivo che supporta il live streaming.
CameraMotion	sdm.devices.traits.CameraMotion Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei movimenti.
CameraPerson	sdm.devices.traits.CameraPerson Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento persone.
CameraSound	sdm.devices.traits.CameraSound Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei suoni.

Campanello

Tratti
DoorbellChime	sdm.devices.traits.DoorbellChime Questo tratto appartiene a qualsiasi dispositivo che supporta il cicalino di un campanello e i relativi eventi di stampa.