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 ในเอกสาร JSON

structure_id

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

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

อุณหภูมิ

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

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

smoke_co_alarms

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

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

กล้อง

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

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

ไป

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

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

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

ชื่อ

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

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

รหัสประเทศ

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

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

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

รหัสไปรษณีย์หรือรหัสไปรษณีย์แล้วแต่ประเทศ

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

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
เครื่องควบคุมอุณหภูมิแบบอ่าน / เขียน / v1-v6
พลังงานอ่าน / v1-v2

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
เครื่องควบคุมอุณหภูมิแบบอ่าน / เขียน / v1-v6
พลังงานอ่าน / v1-v2

เขตเวลา

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

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

การทางพิเศษแห่งประเทศไทย

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

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

eta_begin

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

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

rhr_enrollment

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

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

wwn_security_state

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

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

ที่ไหน

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

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

เรียนรู้เพิ่มเติมเกี่ยวกับสถานที่ที่ชื่อของ Nest Thermostats , Nest Protect and Nest Cams

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

where_id

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

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

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

ชื่อ

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

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

co_alarm_state

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

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

smoke_alarm_state

สถานะสัญญาณเตือนควัน

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