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

ข้อมูลอ้างอิง Nest API

Nest API จำลองบ้านหรืออาคารจริงเป็นโครงสร้าง โดยมี Nest Learning Thermostat, Nest Protect และ Nest Cam เป็นอุปกรณ์ในโครงสร้าง โครงสร้างนี้ยังประกอบด้วยข้อมูลเกี่ยวกับบ้านโดยรวม (เช่น รัฐไม่อยู่หรือ ETA หรือ Rush Hour ที่ใช้งานอยู่)

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

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

จาก API คุณสามารถซิงค์ข้อมูลจากตำแหน่งได้หลายระดับในแบบจำลองข้อมูล เช่น

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

ผลิตภัณฑ์ของคุณควรตอบสนองต่อเหตุการณ์เช่นนี้อย่างรอบคอบ

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

สิทธิ์และข้อมูลอุปกรณ์ที่ใช้ร่วมกัน

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

สำหรับข้อมูลเพิ่มเติมโปรดดูที่ การอนุญาตภาพรวม

ข้อมูลและความเป็นส่วนตัว

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

เรียนรู้เพิ่มเติมเกี่ยวกับ มุมมองของเราในความเป็นส่วนตัว

ข้อมูลเมตา

ข้อมูลเมตาเป็นข้อมูลเพิ่มเติมที่ให้ไว้เมื่อคุณทำการเรียกไปยังจุดปลายระดับราก:

https://developer-api.nest.com/

access_token

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

รายละเอียด
คืนสินค้า string
ตัวอย่าง: "c.FmDPkzyzaQe..."

client_version

ไคลเอ็นต์รุ่นเป็นรุ่นที่ผู้ใช้อนุญาตสุดท้ายของลูกค้าและมีความสัมพันธ์กับ access_token

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

รายละเอียด
คืนสินค้า number
ตัวอย่าง: 1, 17, 42

user_id

ID ผู้ใช้ช่วยให้คุณระบุผู้ใช้ในการเรียก API ตัวระบุนี้จะแตกต่างกันไปตามผลิตภัณฑ์ Works with Nest และผู้ใช้แต่ละชุด

ตัวอย่างเช่นหากผู้ใช้ 1 ได้รับอนุญาตทำงานร่วมกับ Nest สินค้า A และทำงานร่วมกับผลิตภัณฑ์ Nest B แล้วเป็นสินค้าที่มีหนึ่ง user_id คุ้มค่าสำหรับผู้ใช้ที่ 1 และ B มีสินค้าที่แตกต่างกัน user_id คุ้มค่าสำหรับผู้ใช้ 1

รายละเอียด
คืนสินค้า string
ตัวอย่าง: z.1.1.7DHps...