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

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

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

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

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

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

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

แบบจำลองข้อมูล

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

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

devices Nest เป็นตัวแทนของ devices จริง (ตัวควบคุมอุณหภูมิการป้องกันและกล้องถ่ายรูป) ภายในโครงสร้าง

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

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

สำรวจโมเดลข้อมูลด้วย การอ้างอิง API แบบโต้ตอบ นี้

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

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

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

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

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

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

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

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

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

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

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