Google มุ่งมั่นที่จะพัฒนาความเท่าเทียมทางเชื้อชาติสำหรับชุมชนคนผิวดำ มาดูกันว่า
หน้านี้ได้รับการแปลโดย 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 หมายถึงอะไรและวิธีจัดการกับ ข้อผิดพลาด เหล่านี้ให้ดูที่ ข้อความผิดพลาด