หน้านี้ได้รับการแปลโดย Cloud Translation API

ลักษณะเฉพาะ

ลักษณะใน SDM API ประกอบด้วยช่อง คำสั่ง และเหตุการณ์

วันที่

การเรียกไปยัง SDM API ทั้งหมดควรใช้ข้อมูลต่อไปนี้ อุปกรณ์ปลายทาง:
https://smartdevicemanagement.googleapis.com/v1

ช่อง

ช่องคือค่าที่มีประเภทข้อมูลทั่วไป เช่น ตัวเลขหรือสตริง เช่น ช่อง อาจมีโหมดปัจจุบันหรือความชื้นโดยรอบของ Google Nest Thermostat

คุณดูลักษณะและช่องได้ด้วยการเรียก GET ไปยังปลายทาง API ที่ต้องการ

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

ประเภทอุปกรณ์

ไม่ควรใช้ sdm.devices.types.device-type ที่ SDM API แสดงผล เพื่ออนุมานหรืออนุมานฟังก์ชันการทำงานของอุปกรณ์จริงที่กำหนดไว้ ไม่มีการรับประกัน ว่าอุปกรณ์ประเภทหนึ่งๆ จะมีความเสถียรต่ออุปกรณ์หนึ่งๆ เมื่อมีการเพิ่มฟีเจอร์เพิ่มเติมลงใน SDM API แต่ให้ใช้ลักษณะที่แสดงผลสำหรับอุปกรณ์แทน

parentRelations

ออบเจ็กต์ parentRelations แสดงทรัพยากรระดับบนสุดของทรัพยากรปัจจุบัน โครงสร้างหรือห้อง ชื่อที่แสดงสอดคล้องกับช่อง customName ของ ลักษณะของข้อมูล สำหรับอุปกรณ์ที่มีโครงสร้างหลักหรือ ลักษณะ RoomInfo สำหรับอุปกรณ์ที่มี ผู้ปกครองของห้องแชท

คำสั่ง

คำสั่งคือคำขอที่เชื่อมโยงกับลักษณะหนึ่งๆ ตัวอย่างเช่น การเปลี่ยนโหมดปัจจุบัน หรือ อุณหภูมิที่กำหนดบน Google Nest Thermostat

คำสั่งจะส่งโดยการเรียก API ของ executeCommand:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

การตอบสนองต่อคำสั่งส่วนใหญ่มักเป็นความสำเร็จหรือความล้มเหลวง่ายๆ ดูคำแนะนำลักษณะเฉพาะแต่ละรายการสำหรับ ตัวอย่างการใช้คำสั่งที่เจาะจง

กิจกรรม

เหตุการณ์เป็นแบบไม่พร้อมกันและจัดการโดย Google Cloud Pub/Sub ในหัวข้อเดียวตาม Project รหัส

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