ThermostatEco スキーマ

Google Nest Thermostat 

sdm.devices.traits.ThermostatEco

このトレイトは、ECO モードをサポートする THERMOSTAT のデバイスタイプに使用します。

フィールド

フィールド 説明 データ型
availableModes サポートされているエコモードのリスト。 array(string)
値: ["MANUAL_ECO", "OFF"]
mode サーモスタットの現在のエコモード。 string
値: "MANUAL_ECO"、"OFF"
heatCelsius サーモスタットがエコモードで暖房を開始する最低温度（摂氏）。 number
例: 20.0
coolCelsius サーモスタットがエコモードで冷房を開始する最高温度（摂氏）。 number
例: 22.0

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

リクエスト

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

レスポンス

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

コマンド

SetMode

サーモスタットのエコモードを変更します。

サーモスタットのモードを HEAT、COOL、または HEATCOOL に変更するには、 ThermostatMode トレイトの SetMode コマンドを使用します。

このコマンドは、エコモードの現在のステータスまたはエコモードへの変更に基づいて、他のトレイトに影響します。

  • エコモードがオフの場合、サーモスタット モードは前回使用した標準モード（暖房、冷房、暖房、オフ）にデフォルトで設定されます。
  • エコモードが MANUAL_ECO の場合:

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

リクエスト

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

レスポンス

{}

SetMode リクエスト フィールド

フィールド 説明 データ型
mode サーモスタットをエコモードに切り替える。 string
値: "MANUAL_ECO"、"OFF"

エラー

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

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

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