Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

サーモスタットAPI

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

ユーザーは複数の巣のサーモスタットを追加することができますdevices/thermostatsに、グループ最大の構造ごとの最大。このデータの場所に電話をかけると、Nest Thermostatデータ(構造内のデバイスのデータ値)にアクセスできます。

値以下のすべてのそれぞれの下で発見されたdevices/thermostats/ device_id JSONドキュメントインチ

デバイスID

ネストサーモスタットの一意の識別子。

詳細
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

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

last_connection

中に巣サービスと最後に成功した対話のタイムスタンプ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

Temperature_scale

華氏または摂氏;温度表示で使用されます。

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

ターゲット_温度_f

華氏(1°F)での望ましい温度。ときに使用しhvac_mode = heatcool

詳細
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度(0.5°C))。ときに使用しhvac_mode = heatcool

詳細
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 (ヒート•冷却モード)。

詳細
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度(0.5°C)で表示されます。使用hvac_mode = 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 (ヒート•冷却モード)。

詳細
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度(0.5°C)で表示されます。使用hvac_mode = 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度(0.5°C)で表示されます。ときに使用し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度(0.5°C)で表示されます。ときに使用し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度(0.5°C)で表示される最大離れた温度。

詳細
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度(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度)。

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

周囲温度_c

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

詳細
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 、デバイスの表示名。

名前場所についての詳細はこちら 巣のサーモスタット巣を保護し、巣カム

詳細
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

lockd_temp_min_f

最小サーモスタットロック温度は、全体華氏(1°F)で表示しました。ときに使用しis_lockedあるtrue

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

lockd_temp_max_f

最大サーモスタットロック全体華氏(1°F)に表示された温度、。ときに使用しis_lockedあるtrue

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

lockd_temp_min_c

最小サーモスタットロック温度は、半摂氏度(0.5°C)に表示され、表示されます。ときに使用しis_lockedあるtrue

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

lockd_temp_max_c

最大サーモスタットロック温度は、半摂氏度(0.5°C)に表示され、表示されます。ときに使用しis_lockedある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_active 。ときtrue 、日焼け止めの技術が有効になっている、とサーモスタットは自動的に、直射日光に調整読み、正しい温度を設定しています。

詳細については、日焼け止めは何ですか?

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

日光補正_アクティブ

日焼け止めのアクティブステータス。使用sunlight_correction_enabled 。ときtrue 、サーモスタットは、直射日光に位置していることを示しています。

詳細については、日焼け止めは何ですか?

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

where_name

デバイスの表示名。サーモスタットに関連したwhere_id 。私たちが提供するリストからの任意の部屋名、またはカスタム名にすることができます。名前場所についての詳細はこちら 巣のサーモスタット巣を保護し、巣カム

詳細
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

構造が目標温度に到達するまでにかかる時間(分単位)。

参照タイム・ツー・温度の詳細については。

詳細
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 システムについて学習し、目標温度に到達するまでにかかる時間を検出します。サーモスタットが目標温度に到達するまでの時間の合理的な見積りを行うのに十分な情報を持っている場合は、この値から変更されますtrainingready

参照タイム・ツー・温度の詳細については。

詳細
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古いファームウェアを持つデバイス上で。

エコと非エコモードbetwen切り替えの詳細については、参照サーモスタットガイド

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