สคีมา ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

ลักษณะการทำงานนี้เป็นของอุปกรณ์ประเภท THERMOSTAT ที่รองรับการตั้งค่าอุณหภูมิเป้าหมายและช่วงอุณหภูมิ

ช่อง

ช่อง คำอธิบาย ประเภทข้อมูล
heatCelsius อุณหภูมิเป้าหมายเป็นเซลเซียสสำหรับโหมดทำความร้อน (HEAT) และทำความร้อน/ทำความเย็น (HEATCOOL) ของตัวควบคุมอุณหภูมิ number
ตัวอย่าง: 20.0
coolCelsius อุณหภูมิเป้าหมายเป็นเซลเซียสสำหรับโหมดทำความเย็น (COOL) และทำความร้อน/ทำความเย็น (HEATCOOL) ของตัวควบคุมอุณหภูมิ number
ตัวอย่าง: 22.0

ตัวอย่างคำขอและการตอบกลับ GET - HEAT

ส่งคำขอ

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

การตอบกลับ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

ตัวอย่างคำขอ GET และการตอบกลับ - COOL

ส่งคำขอ

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

การตอบกลับ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

ตัวอย่างคำขอ GET และการตอบกลับ - HEATCOOL

ส่งคำขอ

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

การตอบกลับ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

คำสั่ง

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

ตัวอย่างเช่น หากต้องการออกคำสั่ง SetHeat ตัวควบคุมอุณหภูมิต้องอยู่ในโหมดทำความร้อน (HEAT) ก่อน

โหมด คำสั่ง ช่อง
ทำความร้อน (HEAT) SetHeat heatCelsius
COOL SetCool coolCelsius
ทำความร้อน/ทำความเย็น (HEATCOOL) SetRange heatCelsius, coolCelsius

โปรดทราบว่าคำสั่งอุณหภูมิที่กำหนดจะใช้องศาเซลเซียสเป็นพารามิเตอร์เท่านั้น แม้ว่า ตัวควบคุมอุณหภูมิ Google Nest จะแสดงอุณหภูมิเป็นองศาเซลเซียสหรือฟาเรนไฮต์ก็ได้

SetHeat

ตั้งค่าอุณหภูมิเป้าหมายเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน (HEAT)

คำขอและการตอบกลับ SetHeat

ส่งคำขอ

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

การตอบกลับ

{}

ช่องคำขอ SetHeat

ช่อง คำอธิบาย ประเภทข้อมูล
heatCelsius อุณหภูมิเป้าหมายที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน (HEAT) number
ตัวอย่าง: 22.0

SetCool

ตั้งค่าอุณหภูมิเป้าหมายเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความเย็น (COOL)

คำขอและการตอบกลับ SetCool

ส่งคำขอ

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

การตอบกลับ

{}

ช่องคำขอ SetCool

ช่อง คำอธิบาย ประเภทข้อมูล
coolCelsius อุณหภูมิเป้าหมายที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความเย็น (COOL) number
ตัวอย่าง: 20.0

SetRange

ตั้งค่าอุณหภูมิต่ำสุดและสูงสุดเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน/ทำความเย็น (HEATCOOL)

คำขอและการตอบกลับ SetRange

ส่งคำขอ

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

การตอบกลับ

{}

ช่องคำขอ SetRange

ช่อง คำอธิบาย ประเภทข้อมูล
heatCelsius อุณหภูมิเป้าหมายต่ำสุดที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน/ทำความเย็น (HEATCOOL) number
ตัวอย่าง: 20.0
coolCelsius อุณหภูมิเป้าหมายสูงสุดที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน/ทำความเย็น (HEATCOOL) number
ตัวอย่าง: 22.0

ข้อผิดพลาด

ระบบอาจแสดงรหัสข้อผิดพลาดต่อไปนี้ที่เกี่ยวข้องกับลักษณะการทำงานนี้

ข้อความแสดงข้อผิดพลาด RPC การแก้ปัญหา
ไม่อนุญาตให้ใช้คำสั่งในโหมดตัวควบคุมอุณหภูมิปัจจุบัน FAILED_PRECONDITION ตัวควบคุมอุณหภูมิบางรุ่นไม่รองรับการเปลี่ยนโหมดอีโคเมื่อโหมดตัวควบคุมอุณหภูมิเป็นปิด (OFF) ตามลักษณะการทำงาน ThermostatMode คุณต้องเปลี่ยนโหมดตัวควบคุมอุณหภูมิเป็นทำความร้อน (HEAT), ทำความเย็น (COOL) หรือทำความร้อน/ทำความเย็น (HEATCOOL) ก่อนที่จะเปลี่ยนโหมดอีโค
ค่าทำความเย็นต้องมากกว่าค่าทำความร้อน INVALID_ARGUMENT ตรวจสอบว่าช่อง heatCelsius มีค่าน้อยกว่าช่อง coolCelsius ในคำสั่ง
ไม่อนุญาตให้ใช้คำสั่งเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดอีโคแบบกำหนดเอง (MANUAL_ECO) FAILED_PRECONDITION คุณไม่สามารถตั้งค่าอุณหภูมิที่กำหนดเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดอีโคแบบกำหนดเอง

ดูรายการรหัสข้อผิดพลาดทั้งหมดของ API ได้ที่ข้อมูลอ้างอิงรหัสข้อผิดพลาดของ API สำหรับ