Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

โครงสร้าง API

ผู้ใช้สามารถเพิ่ม โครงสร้างได้สูงสุดสามโครงสร้าง โดยมีอุปกรณ์หลายชิ้นต่อโครงสร้าง

ค่าด้านล่างทั้งหมดพบได้ในแต่ละ structures/ structure_id _id ในเอกสาร JSON

โครงสร้าง _id

หมายเลข ID ของโครงสร้าง เมื่อคุณโทรไปยังตำแหน่งข้อมูลนี้คุณสามารถเข้าถึงค่าข้อมูลในโครงสร้างนี้ได้

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /structure_id
ผลตอบแทน string
ตัวอย่าง: "VqFabWH21nw ... "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v1-v2.0
ETA เขียน / v1-v2.0
อ่านรหัสไปรษณีย์ / v2.0
กล้องอ่าน / v1-v3.0
กล้องอ่าน + ภาพ / v1-v4.0
กล้องอ่าน / เขียน / v1-v3.0
กล้องอ่าน / เขียน + ภาพ / v1-v4.0
อ่านพลังงาน / v2.0

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

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

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /thermostats
ผลตอบแทน array
ตัวอย่าง: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v1-v2.0
ETA เขียน / v1-v2.0
กล้องอ่าน / v2-v3.0
กล้องอ่าน + ภาพ / v2-v4.0
กล้องอ่าน / เขียน / v2-v3.0
กล้องอ่าน / เขียน + ภาพ / v2-v4.0

smoke_co_alarms

รายการสัญญาณเตือนควัน + CO ในโครงสร้างโดยตัวระบุอุปกรณ์ที่ไม่ซ้ำกัน นี่คืออาร์เรย์ของออบเจ็กต์ JSON ที่มีสัญญาณเตือนควัน + CO ทั้งหมดในโครงสร้าง

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
ผลตอบแทน array
ตัวอย่าง: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v1-v2.0
ETA เขียน / v1-v2.0
กล้องอ่าน / v2-v3.0
กล้องอ่าน + ภาพ / v2-v4.0
กล้องอ่าน / เขียน / v2-v3.0
กล้องอ่าน / เขียน + ภาพ / v2-v4.0

กล้อง

รายชื่อกล้องในโครงสร้างตามตัวระบุอุปกรณ์ที่ไม่ซ้ำกัน นี่คืออาร์เรย์ของออบเจ็กต์ JSON ที่รวมกล้องทั้งหมดไว้ในโครงสร้าง

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /cameras
ผลตอบแทน array
ตัวอย่าง: [ "awJo6rH...",... ]
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v4-v6.0
เทอร์โมอ่าน / เขียน / v4-v6.0
ควัน + CO อ่าน / v4-v5.0
ไม่อยู่อ่าน / v2.0
ไม่อยู่อ่าน / เขียน / v2.0
ETA เขียน / v2.0
กล้องอ่าน / v1-v3.0
กล้องอ่าน + ภาพ / v1-v4.0
กล้องอ่าน / เขียน / v1-v3.0
กล้องอ่าน / เขียน + ภาพ / v1-v4.0

ออกไป

ระบุสถานะการเข้าพักของโครงสร้าง

โครงสร้างมีสองสถานะที่เกี่ยวข้องกับการมีอยู่: home หรือไม่ away เมื่อไม่มีการเคลื่อนไหวใด ๆ ในบ้านโครงสร้างจะเปลี่ยนจาก home เป็นที่ away

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /away
ผลตอบแทน string
ค่า: "บ้าน", "ไม่อยู่"
เข้าไป อ่านเขียน
มีจำหน่ายใน อ่าน:
อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v1-v2.0
ETA เขียน / v1-v2.0
เขียน:
ไม่อยู่อ่าน / เขียน / v1-v2.0

ชื่อ

ชื่อที่แสดงของโครงสร้างที่ผู้ใช้กำหนดเอง

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /name
ผลตอบแทน string
ตัวอย่าง: "My Home", "Beach House", "Mountain House"
เข้าไป อ่านเขียน
มีจำหน่ายใน อ่าน:
อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v1-v2.0
ETA เขียน / v1-v2.0
อ่านรหัสไปรษณีย์ / v2.0
กล้องอ่าน / v1-v3.0
กล้องอ่าน + ภาพ / v1-v4.0
กล้องอ่าน / เขียน / v1-v3.0
กล้องอ่าน / เขียน + ภาพ / v1-v4.0
อ่านพลังงาน / v2.0
โครงสร้างอ่าน / เขียน / v1.0
เขียน:
โครงสร้างอ่าน / เขียน / v1.0

รหัสประเทศ

รหัสประเทศในรูปแบบ ISO 3166 alpha-2

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /country_code
ผลตอบแทน string
ตัวอย่าง: "US", "CA", "UK"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v1-v2.0
ETA เขียน / v1-v2.0

รหัสไปรษณีย์

ไปรษณีย์หรือรหัสไปรษณีย์ขึ้นอยู่กับประเทศ

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /postal_code
ผลตอบแทน string
ตัวอย่าง: "94304", "94304-1027", "EC1A 1BB"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านรหัสไปรษณีย์ / v1-v2.0

peak_period_start_time

เวลาเริ่มต้นของเหตุการณ์ ชั่วโมงเร่งด่วนด้านพลังงาน ในรูปแบบ ISO 8601

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
ผลตอบแทน string
ตัวอย่าง: "2016-12-31T23: 59: 59.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านเทอร์โมสตัท / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
อ่านพลังงาน / v1-v2.0

peak_period_end_time

เวลาสิ้นสุดของเหตุการณ์ ชั่วโมงเร่งด่วนด้านพลังงาน ในรูปแบบ ISO 8601

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
ผลตอบแทน string
ตัวอย่าง: "2016-12-31T23: 59: 59.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
อ่านพลังงาน / v1-v2.0

เขตเวลา

โซนเวลาที่โครงสร้างในรูปแบบ โซนเวลา IANA

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /time_zone
ผลตอบแทน string
ตัวอย่าง: "America / Los_Angeles"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านตัวควบคุมอุณหภูมิ / v1-v6.0
เทอร์โมอ่าน / เขียน / v1-v6.0
ควัน + CO อ่าน / v1-v5.0
ไม่อยู่อ่าน / v1-v2.0
ไม่อยู่อ่าน / เขียน / v2.0
ETA เขียน / v1-v2.0

eta

ETA (เวลามาถึงโดยประมาณ) คือวัตถุที่สามารถตั้งค่าบนโครงสร้างได้ ใช้เพื่อแจ้งให้ Nest ทราบว่าผู้ใช้คาดว่าจะกลับบ้านในเวลาที่กำหนด สำหรับข้อมูลเกี่ยวกับวิธีโทร ETA โปรดดู คู่มือ Away

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /eta
ผลตอบแทน object
ตัวอย่าง: "myTripID1024", "2014-10-31T22: 42: 00.000Z", "2016-12-31T23: 59: 59.000Z"
พารามิเตอร์
trip_id สตริงที่ผู้ใช้กำหนดเพื่อระบุการเดินทาง
estimated_arrival_window_begin การประทับเวลาในรูปแบบ ISO 8601
ต้องมากกว่า NOW
estimated_arrival_window_end การประทับเวลาในรูปแบบ ISO 8601
ต้องมากกว่า estimated_arrival_window_begin
เข้าไป เขียนอย่างเดียว
มีจำหน่ายใน ETA เขียน / v1-v2.0

eta_begin

การประทับเวลาของเวลาที่คาดว่าจะมาถึงเร็วที่สุดในรูปแบบ ISO 8601 ใช้เพื่อทริกเกอร์การกระทำหรือเหตุการณ์

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /eta_begin
ผลตอบแทน string
ตัวอย่าง: "2016-12-31T23: 59: 59.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน ETA อ่าน / v1.0

rhr_enrollment

สถานะการลงทะเบียน Rush Hour Rewards

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
ผลตอบแทน boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่านพลังงาน / v1-v2.0

wwn_security_state

สถานะความปลอดภัยของโครงสร้าง

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
ประเภท string enum
ค่า: "ตกลง" "ยับยั้ง"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน สถานะความปลอดภัยอ่าน / v1.0

ที่ไหน

อ็อบเจ็กต์ที่มีตัวระบุ ( where_id และ name ) สำหรับอุปกรณ์ในโครงสร้าง name คือ name ที่แสดงของอุปกรณ์ อาจเป็นชื่อห้องใดก็ได้จากรายการที่เรามีให้หรือชื่อที่กำหนดเอง

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ wheres โปรดดู คู่มือโครงสร้าง

เรียนรู้เพิ่มเติมเกี่ยวกับตำแหน่งของชื่อ Nest Thermostats ,Nest Protects และ Nest Cams

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /wheres
ผลตอบแทน object
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่าน:
อ่านตัวควบคุมอุณหภูมิ / v3-v6.0
เทอร์โมอ่าน / เขียน / v3-v6.0
ควัน + CO อ่าน / v3-v5.0
กล้องอ่าน / v1-v3.0
กล้องอ่าน + ภาพ / v1-v4.0
กล้องอ่าน / เขียน / v1-v3.0
กล้องอ่าน / เขียน + ภาพ / v1-v4.0

where_id

ตัวระบุที่สร้างขึ้นโดยไม่ซ้ำกันซึ่งแสดงถึง name

where_id ถูกสร้างขึ้นโดยอัตโนมัติและส่งคืนระหว่างการเรียกเพื่อสร้าง name

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
ผลตอบแทน string
ตัวอย่าง: "Fqp6wJI ... "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน อ่าน:
อ่านตัวควบคุมอุณหภูมิ / v3-v6.0
เทอร์โมอ่าน / เขียน / v3-v6.0
ควัน + CO อ่าน / v3-v5.0
กล้องอ่าน / v1-v3.0
กล้องอ่าน + ภาพ / v1-v4.0
กล้องอ่าน / เขียน / v1-v3.0
กล้องอ่าน / เขียน + ภาพ / v1-v4.0

ชื่อ

ชื่อที่แสดงของอุปกรณ์

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
ผลตอบแทน string
ตัวอย่าง: "ห้องนอน"
เข้าไป อ่านเขียน
มีจำหน่ายใน อ่าน:
อ่านตัวควบคุมอุณหภูมิ / v3-v6.0
เทอร์โมอ่าน / เขียน / v3-v6.0
ควัน + CO อ่าน / v3-v5.0
กล้องอ่าน / v1-v3.0
กล้องอ่าน + ภาพ / v1-v4.0
กล้องอ่าน / เขียน / v1-v3.0
กล้องอ่าน / เขียน + ภาพ / v1-v4.0

co_alarm_state

สถานะการเตือน CO

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
ผลตอบแทน string enum
ค่า: "ตกลง" "คำเตือน" "ฉุกเฉิน"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน ควัน + CO อ่าน / v5.0

smoke_alarm_state

สถานะการเตือนควัน

รายละเอียด
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
ผลตอบแทน string enum
ค่า: "ตกลง" "คำเตือน" "ฉุกเฉิน"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน ควัน + CO อ่าน / v5.0