Notice: We're retiring Works with Nest. See the home page for more information.
Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。
このページは Cloud Translation API によって翻訳されました。
Switch to English

サーモスタットAPI

Nest APIは、EUのヒートリンク付きサーモスタットEを除き、すべてのNest Learning Thermostat™モデルで機能します。

ユーザーは、複数のNestサーモスタットをdevices/thermostatsグループに、 構造あたり最大数まで追加できます。このデータの場所を呼び出すと、Nest Thermostatデータ(構造内のデバイスのデータ値)にアクセスできます。

以下の値はすべて、JSONドキュメントの各devices/thermostats/ device_idにあります。

デバイスID

Nest Thermostatの一意の識別子。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
戻り値 string
例:「peyiJNo0IldT2YlIVtYaGQ」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

ロケール

言語と地域(または国)の設定を指定します。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /locale
戻り値 string
例:「en-GB」、「en-US」、「es-US」、「fr-CA」、「fr-CA」、「nl-NL」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

ソフトウェアバージョン

ソフトウェアバージョン。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
戻り値 string
例:「4.0」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

structure_id

構造の一意の識別子。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
戻り値 string
例:「VqFabWH21nw ...」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

名前

デバイスの表示名。私たちが提供するリストからの任意の部屋名、またはカスタム名にすることができます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /name
戻り値 string
例:「廊下」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

name_long

デバイスの長い表示名。ユーザーによって、またはwheresを介して作成されたカスタム(ラベル)をwheresます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
戻り値 string
例:「廊下のサーモスタット(2階)」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

last_connection

Nestサービスとの最後の正常な対話のタイムスタンプ( ISO 8601形式)。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
戻り値 string
例:「2016-12-31T23:59:59.000Z」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

オンラインです

Nestサービスとのデバイス接続ステータス。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

can_cool

冷却するシステム能力(ACあり)。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

can_heat

加熱するシステム能力。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

is_using_emergency_heat

冷却用ヒートポンプを備えたシステムの緊急ヒートステータス。

緊急ヒートがオンの場合:

  • ユーザーはデバイスの目標温度を調整できますが、緊急ヒートがオフになるまでモードを変更できません
  • hvac_modeは引き続きAPIを介して変更できます

緊急熱とは? Nestサーモスタットが緊急時の熱をサポートする方法の詳細については、

細部
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

has_fan

加熱または冷却から独立してファンを制御するシステム機能。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

fan_timer_active

ファンタイマーが作動しているかどうかを示します。 fan_timer_durationと共に使用して、(ユーザー指定の)事前設定された期間ファンをオンにします。

顧客がファンの持続時間を設定する方法の詳細については、 高度なファン制御を参照してください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
戻り値 boolean
値:true、false
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

fan_timer_timeout

ファンタイマーが0(停止時間)に達したときを示すタイムスタンプ( ISO 8601形式)。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
戻り値 string
例:「2016-12-31T23:59:59.000Z」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

has_leaf

サーモスタットが省エネ温度に設定されている場合に表示されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

温度スケール

華氏または摂氏。温度表示と併用します。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
戻り値 string enum
値:「F」、「C」
アクセス 読み書き
で利用可能 読んだ:
サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6
書く:
サーモスタット読み取り/書き込み/ v5-v6

target_temperature_f

華氏(1°F)での望ましい温度。 hvac_mode = heatまたはcool場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
戻り値 number
例:72
範囲 50〜90
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

target_temperature_c

摂氏0.5度の望ましい温度。 hvac_mode = heatまたはcool場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
戻り値 number
例:21.5
範囲 9-32
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

target_temperature_high_f

華氏(1°F)で表示される最大目標温度。 hvac_mode = heat-cool (Heat•Coolモード)の場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
戻り値 number
例:80
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

target_temperature_high_c

最高目標温度。摂氏0.5度で表示されます。 hvac_mode = heat-cool (Heat•Coolモード)の場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
戻り値 number
例:24.5
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

target_temperature_low_f

華氏(1°F)で表示される最小目標温度。 hvac_mode = heat-cool (Heat•Coolモード)の場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
戻り値 number
例:65
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

target_temperature_low_c

最小目標温度。摂氏0.5度で表示されます。 hvac_mode = heat-cool (Heat•Coolモード)の場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
戻り値 number
例:19.5
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

eco_temperature_high_f

最高気温(華氏(1°F)で表示)。 hvac_mode = eco場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
戻り値 number
例:80
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

eco_temperature_high_c

最高気温(摂氏0.5度で表示)。 hvac_mode = eco場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
戻り値 number
例:24.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

eco_temperature_low_f

華氏(1°F)で表示される最低エコ温度。 hvac_mode = eco場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
戻り値 number
例:65
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

eco_temperature_low_c

最小気温、摂氏0.5度で表示。 hvac_mode = eco場合に使用されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
戻り値 number
例:19.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

away_temperature_high_f(廃止予定)

最高気温(華氏(1°F)で表示)。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
戻り値 number
例:80
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

away_temperature_high_c(廃止予定)

最高気温(摂氏0.5度で表示)。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
戻り値 number
例:24.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

away_temperature_low_f(廃止予定)

華氏(1°F)で表示される、最低気温。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
戻り値 number
例:65
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

away_temperature_low_c(廃止予定)

摂氏半分(0.5°C)で表示される最小離隔温度。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
戻り値 number
例:19.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

hvac_mode

HVACシステムの加熱/冷却モードを示します。たとえば、加熱能力と冷却能力を備えたシステムのHeat•Cool、または省エネのためのEco Temperaturesなどです。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
戻り値 string enum
値:「heat」、「cool」、「heat-cool」、「eco」、「off」
アクセス 読み書き
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

周囲温度_f

デバイスで測定された、華氏全体(1°F)の温度。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
戻り値 number
例:72
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

周囲温度_c

デバイスで測定された温度。摂氏0.5度。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
戻り値 number
例:21.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v1-v6
サーモスタットの読み取り/書き込み/ v1-v6

湿度

デバイスで測定された湿度(パーセント(%)形式)。最も近い5%に丸められます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
戻り値 number
例:35
範囲 0〜100
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v2-v6
サーモスタットの読み取り/書き込み/ v2-v6

hvac_state

HVACシステムがアクティブに加熱、冷却、またはオフになっているかどうかを示します。この値を使用して、HVACアクティビティの状態を示します。

off場合、HVACシステムはアクティブに加熱または冷却していません。 hvac_stateはファンの動作とは無関係です。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
戻り値 string enum
値:「加熱」、「冷却」、「オフ」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v3-v6
サーモスタット読み取り/書き込み/ v3-v6

where_id

表すユニークな、ネスト、生成された識別子name 、デバイスの表示名。

NestサーモスタットNest ProtectsNest Camsの名称の詳細をご覧ください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
戻り値 string
例:「d6reb_OZTM ...」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v4-v6
サーモスタット読み取り/書き込み/ v4-v6

ロックされています

サーモスタットロックのステータス。 trueの場合、 サーモスタットロック機能が有効になり、温度範囲が次の最小/最大値に制限されます: locked_temp_min_flocked_temp_max_flocked_temp_min_c 、およびlocked_temp_max_c

細部
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v5-v6
サーモスタット読み取り/書き込み/ v5-v6

locked_temp_min_f

サーモスタットロックの最低温度。華氏で表示されます。 is_lockedtrue場合に使用されtrue

細部
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
戻り値 string
例:65
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v5-v6
サーモスタット読み取り/書き込み/ v5-v6

locked_temp_max_f

サーモスタットロックの最高温度。華氏(1°F)で表示されます。 is_lockedtrue場合に使用されtrue

細部
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
戻り値 string
例:80
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v5-v6
サーモスタット読み取り/書き込み/ v5-v6

locked_temp_min_c

サーモスタットロックの最低温度。摂氏0.5度で表示されます。 is_lockedtrue場合に使用されtrue

細部
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
戻り値 string
例:19.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v5-v6
サーモスタット読み取り/書き込み/ v5-v6

locked_temp_max_c

最大サーモスタットロック温度。摂氏0.5度で表示されます。 is_lockedtrue場合に使用されtrue

細部
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
戻り値 string
例:24.5
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v5-v6
サーモスタット読み取り/書き込み/ v5-v6

ラベル

サーモスタットのカスタムラベル 。かっこ内のwhere名の後に表示されます。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /label
戻り値 string
例:「2階」、「ゲストルーム」、「プレイルーム」
アクセス 読み書き
で利用可能 読んだ:
サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6
書く:
サーモスタット読み取り/書き込み/ v5-v6

sunlight_correction_enabled

日焼け止め有効状態。 sunlight_correction_active使用されsunlight_correction_activetrue 、日焼け止めテクノロジーが有効になり、サーモスタットは直射日光に合わせて自動的に調整し、正しい温度を読み取って設定します。

詳細について 、「 日焼け止めとは 」を参照してください

細部
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

sunlight_correction_active

日焼け止め活性状態。 sunlight_correction_enabledとともに使用されsunlight_correction_enabledtrue場合、サーモスタットが直射日光の下にあることを示します。

詳細について 、「 日焼け止めとは 」を参照してください

細部
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
戻り値 boolean
値:true、false
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

where_name

デバイスの表示名。サーモスタットwhere_idます。私たちが提供するリストからの任意の部屋名、またはカスタム名にすることができます。 NestサーモスタットNest ProtectsNest Camsの名称の詳細をご覧ください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
戻り値 string
例:「廊下」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

fan_timer_duration

ファンが稼働するように設定されている時間の長さ(分単位)を指定します。

fan_timer_active設定は、ファンをオンにします。 fan_timer_timeout値は、 fan_timer_durationが終了に設定されているときのタイムスタンプを示します。

お客様がファンタイマーを設定する方法については、 タイマーの継続時間を参照してください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
戻り値 int
値:15、30、45、60、120、240、480、720
アクセス 読み書き
で利用可能 読んだ:
サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6
書く:
サーモスタット読み取り/書き込み/ v6

time_to_target

構造が目標温度に到達するのにかかる時間(分)。

詳細については、 Time-to-Temperatureを参照してください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
戻り値 string enum
値:「〜0」、「<5」、「〜15」、「〜90」、「120」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

time_to_target_training

Nest ThermostatはトレーニングモードのときにHVACシステムについて学習し、目標温度に到達するまでの時間を検出します。サーモスタットに十分な情報があり、目標温度に到達するまでの時間を合理的に見積もると、この値はtrainingからready変わります。

詳細については、 Time-to-Temperatureを参照してください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
戻り値 string enum
値:「トレーニング」、「準備完了」
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6

previous_hvac_mode

最後に選択されたhvac_mode表示します。ファームウェアが古いデバイスでhvac_mode = ecoから切り替えるときに使用されます。

Ecoモードと非Ecoモードの切り替えの詳細については、 サーモスタットガイドを参照してください。

細部
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
戻り値 string
値:「heat」、「cool」、「heat-cool」、「off」、空白(値なし)
アクセス 読み取り専用
で利用可能 サーモスタット読み取り/ v6
サーモスタット読み取り/書き込み/ v6