Google is committed to advancing racial equity for Black communities. See how.

โครงสร้าง

โครงสร้าง

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

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

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

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

สิทธิ์ของโครงสร้าง

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

ดูวิธีการอนุญาตทำงานใน การอ้างอิง API แบบโต้ตอบ

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

ชื่อ

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

ที่ไหน

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

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

where_id

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

name

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

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

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

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

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

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

สถานะสัญญาณเตือนควันและก๊าซคาร์บอนไดออกไซด์

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

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

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

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

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

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

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

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

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

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

การจำกัดจำนวนอุปกรณ์ที่ Nest รองรับในโครงสร้างหนึ่งๆ

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

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

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