Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Đặc điểm trong API SDM bao gồm các trường, lệnh và sự kiện.
Các trường
Trường là các giá trị có các loại dữ liệu phổ biến, chẳng hạn như số hoặc chuỗi. Ví dụ: một trường có thể chứa chế độ hiện tại hoặc độ ẩm môi trường xung quanh của Google Nest Thermostat.
Bạn có thể xem các đặc điểm và trường bằng lệnh gọi GET đến điểm cuối API mong muốn:
Không nên dùng sdm.devices.types.device-type do API SDM trả về để suy ra hoặc suy luận chức năng của thiết bị thực tế được chỉ định. Không có gì đảm bảo rằng một loại thiết bị sẽ vẫn ổn định trên một thiết bị cụ thể vì có thêm nhiều tính năng được thêm vào API SDM. Thay vào đó, hãy sử dụng các trait được trả về cho thiết bị.
parentRelations
Đối tượng parentRelations đại diện cho tài nguyên mẹ của tài nguyên hiện tại, có thể là một cấu trúc hoặc phòng. Tên hiển thị tương ứng với trường customName củaĐặc điểm thông tin đối với các thiết bị có cấu trúc mẹ hoặctrang của RoomInfo cho mẹ.
Lệnh
Lệnh là các yêu cầu liên kết với một trait. Ví dụ: thay đổi chế độ hiện tại hoặc điểm đặt nhiệt độ trên Google Nest Thermostat.
Hầu hết phản hồi cho một lệnh là một sự thành công hoặc thất bại đơn giản. Hãy xem hướng dẫn về từng trait để tham khảo các ví dụ cụ thể về cách sử dụng lệnh.
Sự kiện
Các sự kiện không đồng bộ và được Google Cloud Pub/Sub quản lý trong một chủ đề duy nhất theo mã Project .
Theo mặc định, sự kiện được gửi khi bạn thay đổi giá trị của trường trait. Những thông báo này cũng có thể được gửi để phản hồi các thao tác cụ thể trên thiết bị hoặc thay đổi trong cách chỉ định tài nguyên. Hãy xem phần
Sự kiện
để biết thêm thông tin.