เทอร์โมสตัท API

Nest API ใช้ได้กับ Nest Learning ThermostatTM ทุกรุ่น ยกเว้นตัวควบคุมอุณหภูมิ E พร้อม Heat Link ในสหภาพยุโรป

ผู้ใช้เพิ่มตัวควบคุมอุณหภูมิ Nest หลายตัวในกลุ่ม devices/thermostats ได้ โดยขึ้นอยู่กับโครงสร้างสูงสุด เมื่อคุณโทรหาตําแหน่งข้อมูลนี้ คุณจะเข้าถึงข้อมูล Nest Thermostat ได้ (ค่าข้อมูลสําหรับอุปกรณ์ในโครงสร้าง)

ค่าทั้งหมดด้านล่างนี้จะอยู่ใน devices/thermostats/device_id แต่ละรายการในเอกสาร JSON

รหัสอุปกรณ์ [device_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

Software_Version

เวอร์ชันซอฟต์แวร์

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/software_version
ส่งคืนstring
ตัวอย่าง: "4.0"
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

รหัสโครงสร้าง

โครงสร้างตัวระบุที่ไม่ซ้ํากัน

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/structure_id
ส่งคืนstring
ตัวอย่าง: "VqFabWH21nw..."
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

name

ชื่อที่แสดงของอุปกรณ์ อาจเป็นชื่อห้องใดก็ได้จากรายการที่เรามี หรือชื่อที่กําหนดเอง

รายละเอียด
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
ตัวอย่าง: "ห้องโถง Hallway (ชั้นบน)"
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

การเชื่อมต่อสุดท้าย

การประทับเวลาการโต้ตอบที่สําเร็จกับบริการ 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

ระบบทําความเย็นได้ (มีเครื่องปรับอากาศ)

รายละเอียด
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

การใช้ไฟฉุกเฉิน

สถานะแหล่งความร้อนฉุกเฉินในระบบที่มีปั๊มความร้อนสําหรับการทําความเย็น

เมื่อเปิดแหล่งความร้อนฉุกเฉิน

  • ผู้ใช้ปรับอุณหภูมิเป้าหมายในอุปกรณ์ได้ แต่เปลี่ยนโหมดไม่ได้จนกว่าจะปิด "แหล่งความร้อนฉุกเฉิน"
  • คุณยังเปลี่ยนแปลง hvac_mode ได้ผ่าน API

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ Nest Thermostat รองรับแหล่งความร้อนฉุกเฉินได้ในฉุกเฉินคืออะไร

รายละเอียด
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_duration เพื่อเปิดพัดลมในระยะเวลาที่กําหนดไว้ล่วงหน้า (ระบุโดยผู้ใช้)

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ลูกค้ากําหนดระยะเวลาของพัดลมได้ที่การควบคุมพัดลมขั้นสูง

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/fan_timer_active
ส่งคืนboolean
ค่า: true, false
สิทธิ์เข้าถึงอ่าน/เขียน
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

เวลาพัดลม

การประทับเวลาจะปรากฏขึ้นเมื่อตัวจับเวลาพัดลมเหลือ 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

มีใบไม้

แสดงเมื่อตั้งค่าตัวควบคุมอุณหภูมิเป็นอุณหภูมิที่ช่วยประหยัดพลังงาน

รายละเอียด
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°C) ใช้เมื่อ 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 (แบบทําความร้อน • โหมดทําความเย็น)

รายละเอียด
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°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°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

อุณหภูมิสูงสุดในโหมดอีโค

อุณหภูมิในโหมดอีโคสูงสุดที่แสดงในหน่วยฟาเรนไฮต์ (1°F) ใช้เมื่อ hvac_mode = eco

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_f
ส่งคืนnumber
เช่น 80
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

อุณหภูมิสูงสุดในโหมดอีโค

อุณหภูมิในโหมดอีโคสูงสุดที่แสดงเป็นองศาเซลเซียส (0.5°C) ใช้เมื่อ hvac_mode = eco

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_high_c
ส่งคืนnumber
เช่น 24.5
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

อุณหภูมิในโหมดอีโค

อุณหภูมิต่ําสุดในโหมดอีโคที่แสดงในหน่วยฟาเรนไฮต์ (1°F) ใช้เมื่อ hvac_mode = eco

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/eco_temperature_low_f
ส่งคืนnumber
เช่น 65
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

อุณหภูมิในโหมดอีโค

อุณหภูมิต่ําสุดในโหมดอีโคที่แสดงในครึ่งหนึ่งของเซลเซียส (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°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°C)

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/away_temperature_low_c
ส่งคืนnumber
เช่น 19.5
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

โหมด HVAC

ระบุโหมดทําความร้อน/ทําความเย็นของระบบ HVAC เช่น ทําความร้อน • ทําความเย็นสําหรับระบบที่มีกําลังทําความร้อนและความเย็น หรืออุณหภูมิในโหมดอีโคสําหรับการประหยัดพลังงาน

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/hvac_mode
ส่งคืนstring enum
ค่า: "ทําความร้อน" "เย็น" "ทําความร้อน-ทําความเย็น" "อีโค" "ปิด"
สิทธิ์เข้าถึงอ่าน/เขียน
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

อุณหภูมิแวดล้อม

อุณหภูมิวัดในอุปกรณ์ในหน่วยฟาเรนไฮต์ (1°F)

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/ambient_temperature_f
ส่งคืนnumber
เช่น 72
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v1-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v1-v6

แอมเบียนท์_อุณหภูมิต่ําสุด

อุณหภูมิที่วัดที่อุปกรณ์มีหน่วยเป็นองศาเซลเซียส (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]

ตัวระบุที่ไม่ซ้ํากันซึ่ง Nest สร้างขึ้นซึ่งแสดงถึง name ซึ่งเป็นชื่อที่แสดงของอุปกรณ์

ดูข้อมูลเพิ่มเติมเกี่ยวกับตําแหน่งที่ชื่อของ Nest Thermostat, Nest Protect และ Nest Cam

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/where_id
ส่งคืนstring
ตัวอย่าง: "d6reb_OZTM..."
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v4-v6
การอ่าน/เขียนตัวควบคุมอุณหภูมิ / v4-v6

is_locked แล้ว

สถานะการล็อกตัวควบคุมอุณหภูมิ เมื่อเป็นจริง ฟีเจอร์ Thermostat Lock จะเปิดใช้อยู่ และจํากัดช่วงอุณหภูมิสําหรับค่าต่ําสุด/สูงสุดต่อไปนี้ locked_temp_min_f locked_temp_max_f, locked_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

ล็อกชั่วคราว [min_f_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

ล็อกอุณหภูมิสูงสุด [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

ล็อกอุณหภูมิต่ําสุด [c_min_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

ล็อกอุณหภูมิสูงสุด [c_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

ป้ายกำกับ

ป้ายที่กําหนดเองของตัวควบคุมอุณหภูมิ ปรากฏในวงเล็บหลังชื่อ

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/label
ส่งคืนstring
เช่น "ชั้นบน" "ห้องรับแขก" "ห้องเด็กเล่น"
สิทธิ์เข้าถึงอ่าน/เขียน
พร้อมใช้งานในอ่าน:
อ่านตัวควบคุมอุณหภูมิ / v6
อ่าน/เขียนตัวควบคุมอุณหภูมิ / v6
เขียน:
อ่าน/เขียนตัวควบคุมอุณหภูมิ / v5 -6v

sunlight_validion_enabled

สถานะการเปิดใช้ Sunblock ใช้กับ sunlight_correction_active เมื่อ true เทคโนโลยี Sunblock เปิดอยู่และตัวควบคุมอุณหภูมิจะปรับเปลี่ยนไปตามแสงแดดโดยตรงโดยอัตโนมัติ รวมทั้งอ่านและตั้งค่าอุณหภูมิให้ถูกต้อง

ดูข้อมูลเพิ่มเติมได้ที่ Sunblock คืออะไร

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_enabled
ส่งคืนboolean
ค่า: true, false
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

sunlight_validion_active

มีสถานะใช้งานอยู่ Sunblock ใช้กับ sunlight_correction_enabled เมื่อ true ระบุว่าตัวควบคุมอุณหภูมิตั้งอยู่ในจุดที่โดนแสงแดดโดยตรง

ดูข้อมูลเพิ่มเติมได้ที่ Sunblock คืออะไร

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/sunlight_correction_active
ส่งคืนboolean
ค่า: true, false
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

ชื่อตําแหน่ง

ชื่อที่แสดงของอุปกรณ์ เชื่อมโยงกับตัวควบคุมอุณหภูมิ where_id อาจเป็นชื่อห้องใดก็ได้จากรายการที่เรามีให้ หรือชื่อที่กําหนดเอง ดูข้อมูลเพิ่มเติมเกี่ยวกับตําแหน่งที่ชื่อของ Nest Thermostat, Nest Protect และ Nest Cam

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/where_name
ส่งคืนstring
ตัวอย่าง: "ห้องโถง"
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

ระยะเวลา_พัดลม

ระบุระยะเวลา (นาที) ที่พัดลมตั้งค่าให้ทํางาน

การตั้งค่า 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

เวลาเป้าหมาย_ฝึกอบรม

เมื่ออยู่ในโหมดการฝึก Nest Thermostat จะเรียนรู้เกี่ยวกับระบบ HVAC และค้นพบระยะเวลาที่ใช้ในการปรับอุณหภูมิให้ถึงเป้าหมาย เมื่อตัวควบคุมอุณหภูมิมีข้อมูลเพียงพอที่จะประเมินอุณหภูมิที่เหมาะสมเพื่อให้ถึงอุณหภูมิที่กําหนด ค่านี้จะเปลี่ยนจาก training เป็น ready

ดูข้อมูลเพิ่มเติมได้ที่เวลาที่ถึงอุณหภูมิ

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/time_to_target_training
ส่งคืนstring enum
ค่า: "ฝึกอบรม", "พร้อม"
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6

โหมด_VAC ก่อนหน้า

แสดง hvac_mode ที่เลือกล่าสุด ใช้เมื่อเปลี่ยนจาก hvac_mode = eco ในอุปกรณ์ที่มีเฟิร์มแวร์ล้าสมัย

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนโหมดโหมดอีโคกับโหมดอีโคกับโหมดอีโคได้ที่คําแนะนําเกี่ยวกับตัวควบคุมอุณหภูมิ

รายละเอียด
https://developer-api.nest.com/devices/thermostats/device_id/previous_hvac_mode
ส่งคืนstring
ค่า: "heat", "cool", "heat-cool", "off", blank (ไม่มีค่า)
สิทธิ์เข้าถึงอ่านอย่างเดียว
พร้อมใช้งานในการอ่านตัวควบคุมอุณหภูมิ / v6
ตัวควบคุมอุณหภูมิแบบอ่าน/เขียน / v6