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