Uma característica na API SDM é composta por campos, comandos e eventos.
Campos
Os campos são valores com tipos de dados comuns, como um número ou uma string. Por exemplo, um campo pode conter o modo atual ou a umidade ambiente de um Google Nest Thermostat.
As características e os campos podem ser visualizados com uma chamada GET para o endpoint da API desejado:
O sdm.devices.types.device-type retornado pela API SDM não pode ser usado para deduzir ou inferir a funcionalidade do dispositivo real a que está atribuído. Não há garantia de que um tipo de dispositivo permanecerá estável em um dispositivo específico à medida que mais recursos forem adicionados à API SDM. Em vez disso, use as características retornadas.
ParentRelations
O objeto parentRelations representa o recurso pai do recurso atual,
uma estrutura ou uma sala. O nome de exibição corresponde ao campo customName da
Info
para dispositivos com uma mãe de estrutura ou à
característica RoomInfo .
Comandos
Os comandos são solicitações associadas a uma característica. Por exemplo, mudar o modo atual ou
a temperatura programada em um Google Nest Thermostat.
Um comando é enviado por uma chamada de API executeCommand:
A maioria das respostas a um comando é um simples sucesso ou falha. Consulte os guias de traço individuais para ver exemplos específicos de uso de comando.
Eventos
Os eventos são assíncronos e gerenciados pelo Google Cloud Pub/Sub em um único tópico por ID Project .
Os eventos são enviados por padrão para qualquer alteração no valor de um campo de característica. Elas também podem ser enviadas em resposta a ações específicas do dispositivo ou alterações nas atribuições de recursos. Consulte Eventos para mais informações.
Essa característica pertence a tipos de dispositivos de THERMOSTAT que podem relatar detalhes do sistema HVAC (Aquecimento, ventilação e ar-condicionado).