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

โครงสร้าง

โครงสร้าง

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

Nest API ให้การเข้าถึงข้อมูลระดับโครงสร้างต่อไปนี้ขึ้นอยู่กับระดับของการอนุญาตที่ได้รับ:

  • ชื่อโครงสร้างและอุปกรณ์ "ที่ชื่อ" (ตำแหน่งในบ้าน)
  • รายการอุปกรณ์ในบ้าน
  • สถานะเหตุการณ์พลังงาน ( ชั่วโมงเร่งด่วนพลังงาน )
  • สถานะไม่อยู่
  • ผู้ใช้ ETA
  • สถานะความปลอดภัย
  • รหัสไปรษณีย์หรือรหัสไปรษณีย์

คุณลักษณะระดับโครงสร้างบางอย่างครอบคลุมอยู่ในคู่มือ API รายละเอียดเพิ่มเติมแยกต่างหาก:

สิทธิ์ในโครงสร้าง

สำหรับการเข้าถึง ... เลือก...
ค่าข้อมูลส่วนใหญ่ในวัตถุ structures ไม่อยู่ ETA พลังงาน หรือการอนุญาตให้ใช้ รหัสไปรษณีย์
ค่าข้อมูล name ในวัตถุ structures โครงสร้างการอ่าน / เขียน อนุญาต

ดูว่าสิทธิ์ทำงานในการ อ้างอิง API เชิงโต้ตอบ ได้อย่างไร

ตัวระบุโครงสร้าง

ชื่อ

ชื่อของโครงสร้างเริ่มต้นที่ "บ้าน" แต่สามารถสตริงใด ๆ ที่ผู้ใช้เลือก เมื่อคุณเลือกสิทธิ์การ อ่าน / เขียนโครงสร้าง คุณสามารถเปลี่ยน name โครงสร้างได้

ที่ไหน

wheres เป็นชุดวัตถุบนโครงสร้างซึ่งมีตัวระบุตำแหน่ง ( where_id และ name ) ใช้ wheres เพื่อสร้างชื่อที่กำหนดเองหรือเข้าถึงมาตรฐานที่ชื่อ

การเข้าถึง wheres วัตถุต้องใช้ กล้อง , สูบบุหรี่ + CO ปลุก หรือ เทอร์โม สิทธิ์

where_id

  • ตัวระบุที่สร้างขึ้นโดยไม่ซ้ำใครซึ่งแสดงถึง name
  • where_id เป็นแบบอ่านอย่างเดียวและถูกสร้างขึ้นโดยอัตโนมัติในการโทรเพื่อสร้าง name ที่กำหนดเอง

name

  • ชื่อที่แสดงของอุปกรณ์ สามารถเป็นชื่อห้องใดก็ได้จากรายการที่เรามีให้หรือชื่อที่กำหนดเอง
  • ในการสร้าง name ที่กำหนดเองให้ทำการเรียก POST เพื่อเขียน name ที่กำหนดเองใหม่ where_id ถูกส่งคืนในการโทร
  • การพิจารณา
    • name ไม่สามารถแก้ไขหรือลบได้หลังจากการสร้าง
    • name จะต้องไม่ซ้ำกันภายในโครงสร้าง
    • หากอุปกรณ์ถูกจับคู่กับโครงสร้างกำหนดเองโดยที่ name เชื่อมโยงกับอุปกรณ์นั้นสามารถเข้าถึงได้จาก /structures/ path
    • เมื่อต้องการย้ายอุปกรณ์ด้วยการกำหนดเองโดยที่ name ไปยังโครงสร้างที่แตกต่างกันให้ยกเลิกการจับคู่อุปกรณ์แล้วจับคู่อุปกรณ์กับชื่อที่ต้องการอีกครั้ง

เรียนรู้เพิ่มเติมเกี่ยวกับชื่อ Nest Nestostost Nest Nest และ Nest Cams

ข้อมูลเมตาอื่น ๆ

ค่าข้อมูลทั้งหมดเป็นแบบอ่านอย่างเดียวเว้นแต่จะระบุไว้เป็นอย่างอื่น

ค่าข้อมูล ลักษณะ
structure_id สตริงที่แสดงถึงโครงสร้างนี้โดยเฉพาะ นักพัฒนาทุกคนจะเห็น ID ที่แตกต่างกันสำหรับโครงสร้างเดียวกัน แต่ผลิตภัณฑ์หลายรายการจากนักพัฒนาเดียวกันจะเห็น ID เดียวกัน
country_code รหัสประเทศ ISO 3166-1 alpha-2 ที่แมปไปยังตำแหน่งที่ลงทะเบียนของโครงสร้าง
postal_code รหัสไปรษณีย์หรือรหัสไปรษณีย์แล้วแต่ประเทศ
time_zone สตริง เขตเวลาของ IANA ที่จับคู่กับเขตเวลาของโครงสร้าง

คุณสมบัติโครงสร้าง

สัญญาณเตือนควันและ CO

เมื่อคุณเลือก สิทธิ์การอ่าน Smoke + CO คุณสามารถเข้าถึง smoke_alarm_state และ co_alarm_state ในวัตถุ structures ค่าข้อมูลเดียวกันเหล่านี้ยังมีอยู่ในวัตถุ devices/smoke_co_alarms ( devices/smoke_co_alarms )

ดู คู่มือการเตือนควัน + CO สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสถานะเหล่านี้

ค่าข้อมูลจำนวนมากทำงานร่วมกันเพื่อกำหนดวิธีการทำงานของอุปกรณ์ในโครงสร้าง

  • เมื่อโครงสร้าง away รัฐเป็นชุดที่จะ away คำว่า "ประหยัด" จะปรากฏบน Nest Thermostat ในภาษาที่ต้องการของผู้ใช้
  • เมื่อสถานะไม่ away โครงสร้างถูกตั้งค่าเป็นไม่ away คุณสามารถ:
    • ตั้ง fan_timer_active
    • เปลี่ยน target_temperature_f หรือ target_temperature_c
  • เมื่อสถานะไม่ away โครงสร้างถูกตั้งไว้ที่ home คุณสามารถ
    • โทร ETA (ตั้งรหัสการเดินทางและหน้าต่างมาถึง)
  • เมื่อ Emergency fan_timer_active ใช้งานคุณไม่สามารถตั้งค่า fan_timer_active
  • เมื่อเปิดใช้งาน Heat Heat คุณจะไม่สามารถกำหนดโครงสร้างให้ away

หลายโครงสร้าง

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

ตัวเลือกโครงสร้าง

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

เรียนรู้วิธีที่ ผู้ใช้จัดการอุปกรณ์ในหลายโครงสร้าง

อุปกรณ์สูงสุด

มีข้อ จำกัด เกี่ยวกับจำนวนอุปกรณ์ที่ Nest รองรับในโครงสร้าง

ประเภทอุปกรณ์ สูงสุดต่อโครงสร้าง
Nest Thermostat 20
กล้องรัง 10
ป้องกันรัง 18

ข้อความผิดพลาด

สำหรับข้อมูลเกี่ยวกับข้อผิดพลาดในการโทร API หมายถึงอะไรและวิธีจัดการกับ ข้อผิดพลาด เหล่านี้ให้ดูที่ ข้อความผิดพลาด