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

สถาปัตยกรรมของ Nest API

เกี่ยวกับบริการ Nest

แอปพลิเคชัน Nest ให้ผู้ใช้เชื่อมต่อกับบ้านได้จากทุกที่ อุปกรณ์ Nest ทั้งหมด (ตัวควบคุมอุณหภูมิ ตัวป้องกัน และกล้อง) และแอปพลิเคชัน (iOS, Android และเว็บแอป) เชื่อมต่อกับบริการ Nest

ตัวอย่าง cloud-to-cloud

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

ตัวอย่างเช่น ตัวควบคุมอุณหภูมิจะอ่านอุณหภูมิเป้าหมายจากแบบจำลองข้อมูล โดยจะตั้งค่าอุณหภูมิแวดล้อมเป็นการวัดปัจจุบัน และส่งข้อมูลเซ็นเซอร์ไปยัง Home/Away Assist ซึ่งจะปรับโหมดโครงสร้างให้สอดคล้องกัน

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

ตัวแบบข้อมูล

เดอะเน API จะแสดงเป็นเอกสาร JSON ที่มีคุณลักษณะที่ระดับสูงสุดของ metadata , devices และ structures ผลิตภัณฑ์ Works with Nest ของคุณใช้เอกสาร JSON นี้เพื่อโต้ตอบและตอบสนองต่ออุปกรณ์ Nest และการเปลี่ยนแปลงสถานะที่เกี่ยวข้อง

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

Nest devices แทนอุปกรณ์ทางกายภาพ (Thermostats ปกป้องและกล้อง) ภายในโครงสร้าง

ทุกองค์ประกอบข้อมูลในเอกสาร JSON สามารถระบุตำแหน่งได้ด้วย URL (เรียกอีกอย่างว่า "ตำแหน่งข้อมูล") ทำงานร่วมกับผลิตภัณฑ์ Nest อ่านและเขียนในส่วนต่างๆ ของเอกสารนี้และสมัครรับการเปลี่ยนแปลงได้ ความสามารถในการสมัครใช้บริการนี้ช่วยให้ผลิตภัณฑ์ Works with Nest ตอบสนองต่อการเปลี่ยนแปลงที่เกิดขึ้นกับระบบแบบเรียลไทม์ เช่น การปิดไฟเมื่อผู้ใช้ตั้งค่าโครงสร้างเป็น "ไม่อยู่"

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

สำรวจรูปแบบข้อมูลกับเรื่องนี้ อ้างอิง API แบบโต้ตอบ

สถานะที่ตั้งใจไว้

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

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

โมเดลการเผยแพร่/สมัครรับข้อมูลเชิงเอกสารนี้จัดเตรียมการโต้ตอบกับแอปพลิเคชันที่ตอบสนอง

การใช้บริการ Nest

หากต้องการเข้าถึงปลายทาง REST ในบริการ Nest ให้ใช้ HTTPS ในผลิตภัณฑ์ของคุณ มีไลบรารีไคลเอนต์บุคคลที่สามมากมายที่สามารถใช้เพื่อจุดประสงค์นี้

สิทธิ์และการอนุญาต

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

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

การให้โทเค็นการเข้าถึงจะสร้างความสัมพันธ์ที่เชื่อถือได้ระหว่างผู้ใช้ ผลิตภัณฑ์ Works with Nest และ Nest ผู้ใช้สามารถเพิกถอนการเข้าถึงได้ตลอดเวลา

เรียนรู้วิธีการอนุญาตให้เชื่อมต่อไปยังรังของ API ให้ดูที่ ภาพรวมการอนุมัติ