ThermostatMode スキーマ

Google Nest Thermostat 

sdm.devices.traits.ThermostatMode

このトレイトは、さまざまなサーモスタット モードに対応する THERMOSTAT デバイスタイプに使用します。

フィールド

フィールド 説明 データ型
availableModes サポートされているサーモスタットのモードのリスト。 array(string)
値: ["HEAT", "COOL", "HEATCOOL", "OFF"]
mode 現在のサーモスタットのモード。 string
値: "HEAT"、"COOL"、"HEATCOOL"、"OFF"

GET リクエストとレスポンスの例

リクエスト

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

レスポンス

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    }
  }
}

コマンド

SetMode

サーモスタットのモードを変更する。

SetMode リクエストとレスポンス

リクエスト

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

レスポンス

{}

SetMode リクエスト フィールド

フィールド 説明 データ型
mode サーモスタットの変更モード。 string
値: "HEAT"、"COOL"、"HEATCOOL"、"OFF"

エラー

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

エラー メッセージ RPC トラブルシューティング
現在のサーモスタット モードではコマンドを使用できません。 FAILED_PRECONDITION 一部のサーモスタット モデルは、 ThermostatMode トレイトに従って、サーモスタット モードがオフのときにエコモードを変更できません。エコモードを変更する前に、サーモスタット モードを [暖房]、[冷房]、[暖房換気空調] に変更する必要があります。

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