Tratti

Un trait nell'API SDM comprende fields, commands ed events.

Tutte le chiamate all'API SDM devono utilizzare il seguente 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.

Puoi vedere i tratti e i campi 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 è assegnato. Non è garantito che un tipo di dispositivo rimanga stabile per un dispositivo specifico man mano che vengono aggiunte altre funzionalità all'API SDM. Utilizza invece le caratteristiche restituite dal dispositivo.

padreRelazione

L'oggetto parentRelations rappresenta la risorsa padre della risorsa corrente, una struttura o una stanza. Il nome visualizzato corrisponde al campo customName dell'elemento Tratto informazioni per i dispositivi con un elemento padre della struttura o al trait RoomInfo {room1

Comandi

I comandi sono richieste associate a un trait. Ad esempio, modificare la modalità corrente o il 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 è un semplice esito positivo o negativo. Consulta le guide individuali sui tratti per esempi di utilizzo specifici dei comandi.

Eventi

Gli eventi sono asincroni e gestiti da Google Cloud Pub/Sub in un unico argomento per Project ID.

Gli eventi vengono inviati per impostazione predefinita a qualsiasi modifica del valore di un campo di trait. Possono anche essere inviati in risposta ad azioni specifiche del dispositivo o modifiche alle assegnazioni di risorse. Per ulteriori informazioni, consulta Eventi.

Categorie di tratti

Struttura

Tratti
Informazioni	sdm.structures.traits.Info Questo tratto appartiene a qualsiasi struttura relativa alle informazioni correlate alla struttura.
Informazioni sulle camere	sdm.structures.traits.RoomInfo Questo tratto appartiene a qualsiasi stanza per informazioni relative alle stanze.

Dispositivo

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

Termostato

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

Fotocamera

Tratti
Anteprima clip fotocamera	sdm.devices.traits.CameraClipPreview Questo tratto appartiene a qualsiasi dispositivo che supporta il download di un'anteprima di clip.
ImmagineEventoFotocamera	sdm.devices.traits.CameraEventImage Questo tratto appartiene a qualsiasi dispositivo che supporta la generazione di immagini da eventi.
Immagine fotocamera	sdm.devices.traits.CameraImage Questo tratto appartiene a qualsiasi dispositivo che supporta l'acquisizione di immagini.
Live streaming con videocamera	sdm.devices.traits.CameraLiveStream Questo tratto appartiene a qualsiasi dispositivo che supporta il live streaming.
Movimento della videocamera	sdm.devices.traits.CameraMotion Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei movimenti.
Persona della videocamera	sdm.devices.traits.CameraPerson Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento persone.
Suono videocamera	sdm.devices.traits.CameraSound Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei suoni.

Campanello

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