Черты

Черта в API SDM включает поля , команды и события .

Поля

Поля — это значения с распространёнными типами данных, такими как числа или строки. Например, поле может содержать текущий режим или влажность воздуха для термостата Google Nest.

Признаки и поля можно просмотреть с помощью вызова GET к желаемой конечной точке API:

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"
    }
  ]
}

Типы устройств

Тип sdm.devices.types. device-type возвращаемый API SDM, не следует использовать для определения функциональности фактического устройства, которому он назначен. Нет гарантии, что тип устройства останется стабильным для конкретного устройства по мере добавления новых функций в API SDM. Вместо этого используйте возвращаемые характеристики устройства.

parentRelations

Команды

Команды — это запросы, связанные с определённым свойством. Например, изменение текущего режима или заданного значения температуры на термостате Google Nest.

Команда отправляется с помощью вызова API executeCommand :

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

Большинство ответов на команду — это просто успех или неудача. Примеры использования конкретных команд см. в руководствах по отдельным характеристикам.

События

События асинхронны и управляются Google Cloud Pub/Sub в одной теме на Project ИДЕНТИФИКАТОР.

События отправляются по умолчанию при любом изменении значения поля характеристики. Они также могут отправляться в ответ на определённые действия устройства или изменения в назначении ресурсов. Подробнее см. в разделе «События» .

Категории черт

Структура

Устройство

Термостат

Камера

Дверной звонок