Una característica en la API de SDM comprende los campos, los comandos y los eventos.
Campos
Los campos son valores con tipos de datos comunes, como un número o una cadena. Por ejemplo, un campo podría contener el modo actual o la humedad ambiente de un Google Nest Thermostat.
Los rasgos y campos se pueden ver con una llamada GET al extremo de API deseado:
El sdm.devices.types.device-type que muestra la API de SDM no debe usarse para deducir o inferir la funcionalidad del dispositivo real al que está asignado. No se garantiza que un tipo de dispositivo se mantenga estable para un dispositivo específico a medida que se agregan más funciones a la API de SDM. En su lugar, usa los traits que se muestran para el dispositivo.
parentRelations
El objeto parentRelations representa el recurso superior del recurso actual, ya sea una estructura o una sala. El nombre visible corresponde al campo customName deInfo para dispositivos que tienen una estructura superior o latrait principal de RoomInfo .
Comandos
Los comandos son solicitudes asociadas con una característica. Por ejemplo, cambiar el modo actual o el punto de ajuste de la temperatura en un Google Nest Thermostat.
Se envía un comando mediante una llamada a la API executeCommand:
La mayoría de las respuestas a un comando son correctas o fallidas. Consulta las guías de características individuales para ver ejemplos específicos de uso de comandos.
Eventos
Los eventos son asíncronos y los administra Google Cloud Pub/Sub en un solo tema por
Project ID.
Los eventos se envían de forma predeterminada para cualquier cambio en el valor de un campo de trait. También se pueden enviar en respuesta a acciones específicas de dispositivos o cambios en las asignaciones de recursos. Consulta Eventos para obtener más información.
Esta característica pertenece a los tipos de dispositivos de TERMOSTATO que admiten la configuración de la temperatura final y el rango de temperatura.