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

อ้างอิง API ของ Nest

Nest API จำลองแบบบ้านหรืออาคารที่มีอยู่จริงเป็นโครงสร้างด้วย Nest Learning Thermostats, Nest Protects และ Nest Cams เป็นอุปกรณ์ในโครงสร้าง โครงสร้างนี้ยังมีข้อมูลเกี่ยวกับบ้านโดยรวม (เช่นสถานะ Away หรือ ETA หรือชั่วโมงเร่งด่วนที่ใช้งานอยู่)

ทุกองค์ประกอบข้อมูลในโครงสร้างสามารถระบุแอดเดรสได้โดย URL ของทรัพยากร (เรียกว่า "data location") ในเอกสาร 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 ตัวระบุนี้แตกต่างกันสำหรับแต่ละผลิตภัณฑ์ที่ทำงานร่วมกับ Nest และชุดค่าผสมของผู้ใช้

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

รายละเอียด
ผลตอบแทน string
ตัวอย่าง: z.1.1.7DHps ...