특성

SDM API의 특성은 필드, 명령어, 이벤트로 구성됩니다.

SDM API에 대한 모든 호출은 다음 엔드포인트를 사용해야 합니다.
https://smartdevicemanagement.googleapis.com/v1

필드

필드는 숫자나 문자열과 같은 일반적인 데이터 유형이 있는 값입니다. 예를 들어 필드에는 Google Nest 온도 조절기의 현재 모드나 주변 습도가 포함될 수 있습니다.

특성과 필드는 원하는 API 엔드포인트에 대한 GET 호출로 볼 수 있습니다.

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 API에서 반환된 sdm.devices.types.device-type은 할당된 실제 기기의 기능을 추론하는 데 사용하면 안 됩니다. SDM API에 더 많은 기능이 추가됨에 따라 특정 기기의 기기 유형이 안정적으로 유지된다고 보장할 수 없습니다. 대신 기기에 반환된 특성을 사용하세요.

parentRelations

parentRelations 객체는 현재 리소스의 상위 리소스(구조 또는 방)를 나타냅니다. 표시 이름은 구조 상위 요소가 있는 기기의Info 특성 또는 방 상위 요소가 있는 기기의RoomInfo 특성 에 해당합니다.

명령어

명령은 특성과 연결된 요청입니다. 예를 들어 Google Nest 온도 조절기에서 현재 모드나 온도 설정값을 변경하는 경우입니다.

명령어는 executeCommand API 호출에 의해 전송됩니다.

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

명령어에 대한 대부분의 응답은 간단한 성공 또는 실패입니다. 구체적인 명령어 사용 예는 개별 특성 가이드를 참고하세요.

이벤트

이벤트는 비동기식이며 Project ID당 단일 주제에서 Google Cloud Pub/Sub에 의해 관리됩니다.

특성 필드의 값이 변경되면 이벤트가 기본적으로 전송됩니다. 특정 기기 작업이나 리소스 할당 변경에 대한 응답으로 전송될 수도 있습니다. 자세한 내용은 이벤트를 참고하세요.

특성 카테고리

구조

특성
정보	sdm.structures.traits.Info 이 특성은 구조 관련 정보의 모든 구조에 속합니다.
RoomInfo	sdm.structures.traits.RoomInfo 이 특성은 객실 관련 정보를 위한 모든 객실에 속합니다.

기기

특성
연결	sdm.devices.traits.Connectivity 이 특성은 연결 정보가 있는 모든 기기에 속합니다.
Fan	sdm.devices.traits.Fan 이 특성은 팬을 제어하는 시스템 기능이 있는 모든 기기에 속합니다.
습도	sdm.devices.traits.Humidity 이 특성은 습도를 측정하는 센서가 있는 모든 기기에 속합니다.
정보	sdm.devices.traits.Info 이 특성은 기기 관련 정보가 있는 모든 기기에 속합니다.
설정	sdm.devices.traits.Settings 이 특성은 기기 관련 설정 정보가 있는 모든 기기에 속합니다.
온도	sdm.devices.traits.Temperature 이 특성은 온도를 측정하는 센서가 있는 모든 기기에 속합니다.

온도 조절기

특성
ThermostatEco	sdm.devices.traits.ThermostatEco 이 특성은 ECO 모드를 지원하는 온도 조절기 기기 유형에 속합니다.
ThermostatHvac	sdm.devices.traits.ThermostatHvac 이 특성은 HVAC 세부정보를 보고할 수 있는 온도 조절기 기기 유형에 속합니다.
ThermostatMode	sdm.devices.traits.ThermostatMode 이 특성은 다양한 온도 조절기 모드를 지원하는 온도 조절기 기기 유형에 속합니다.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint 이 특성은 목표 온도와 온도 범위를 설정하는 기능을 지원하는 온도 조절기 기기 유형에 속합니다.

카메라

특성
CameraClipPreview	sdm.devices.traits.CameraClipPreview 이 특성은 클립 미리보기 다운로드를 지원하는 모든 기기에 속합니다.
CameraEventImage	sdm.devices.traits.CameraEventImage 이 특성은 이벤트에서 이미지를 생성하는 기능을 지원하는 모든 기기에 속합니다.
CameraImage	sdm.devices.traits.CameraImage 이 특성은 이미지를 촬영할 수 있는 모든 기기에 속합니다.
CameraLiveStream	sdm.devices.traits.CameraLiveStream 이 특성은 라이브 스트리밍을 지원하는 모든 기기에 속합니다.
CameraMotion	sdm.devices.traits.CameraMotion 이 특성은 동작 감지 이벤트를 지원하는 모든 기기에 속합니다.
CameraPerson	sdm.devices.traits.CameraPerson 이 특성은 사람 감지 이벤트를 지원하는 모든 기기에 속합니다.
CameraSound	sdm.devices.traits.CameraSound 이 특성은 소리 감지 이벤트를 지원하는 모든 기기에 속합니다.

초인종

특성
DoorbellChime	sdm.devices.traits.DoorbellChime 이 특성은 초인종 차임벨과 관련 누르기 이벤트를 지원하는 모든 기기에 속합니다.