ファンのスキーマ

Google 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

ファンタイマーを変更する。

Set タイマー リクエストとレスポンス

リクエスト

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

レスポンス

{}

Set タイマー リクエスト フィールド

項目 説明 データ型
timerMode ファンタイマーを設定するモード。 string
値: 「ON」、「OFF」
duration 省略可。タイマーを実行する時間を秒単位で指定します。 string
範囲: 「1 秒」～「43,200 秒」
デフォルト: 「900 秒」

エラー

このトレイトに関連して、次のエラーコードが返されることがあります。

エラー メッセージ RPC トラブルシューティング
サーモスタットのファンは利用できません。 FAILED_PRECONDITION サーモスタットにファン機能はありません。ファン関連のトレイトやコマンドは、このデバイスには使用できません。

API エラーコードの完全なリストについては、API エラーコード リファレンスをご覧ください。