팬 스키마

Nest Thermostat 

sdm.devices.traits.Fan

이 트레잇은 팬을 제어하는 시스템 기능이 있는 모든 기기에 속합니다.

필드

필드 설명 데이터 유형
timerMode 현재 타이머 모드입니다. string
값: 'ON', 'OFF'
timerTimeout 타이머 모드가 꺼지는 RFC 3339 형식의 타임스탬프입니다. string
예: '2019-05-10T03:22:54Z'

샘플 GET 요청 및 응답

요청

GET /enterprises/project-id/devices/device-id

응답

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

명령어

SetTimer

팬 타이머를 변경합니다.

SetTimer 요청 및 응답

요청

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

응답

{}

SetTimer 요청 필드

필드 설명 데이터 유형
timerMode 팬 타이머를 설정하는 모드입니다. string
값: 'ON', 'OFF'
duration 선택사항. 타이머가 실행되도록 설정된 시간(초)을 지정합니다. string
범위: '1s'~'43200s'
기본값: '900s'

오류

이 트레잇과 관련하여 다음과 같은 오류 코드가 반환될 수 있습니다.

오류 메시지 RPC 문제 해결
온도 조절기 팬을 사용할 수 없습니다. FAILED_PRECONDITION 온도 조절기에 팬 기능이 없습니다. 이 기기에는 팬 관련 트레잇과 명령어를 사용할 수 없습니다.

API 오류 코드의 전체 목록은 API 오류 코드 참조를 확인하세요.