סכמת מעריצים
sdm.devices.traits.Fan
התכונה הזו שייכת לכל מכשיר שיש לו יכולת לשלוט במאוורר.
שדות
שדה | התיאור | סוג הנתונים |
---|---|---|
timerMode |
מצב הטיימר הנוכחי. | string ערכים: "מופעל", "מושבת" |
timerTimeout |
חותמת זמן בפורמט RFC 3339, שבה מצב הטיימר יכבה. | string דוגמה: "2019-05-10T03:22:54Z" |
דוגמה לבקשה ותגובה של GET
בקשה
GET /enterprises/project-id/devices/device-id
תשובה
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.Fan
" : {
"timerMode" : "ON",
"timerTimeout" : "2019-05-10T03:22:54Z"
}
}
}
פקודות
SetTimer
שינוי הטיימר למאוורר.
בקשה ותגובה של SetTimer
בקשה
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.Fan.SetTimer
",
"params" : {
"timerMode" : "ON",
"duration" : "3600s"
}
}
תשובה
{}
שדות הבקשה של SetTimer
שדה | התיאור | סוג הנתונים |
---|---|---|
timerMode |
המצב להגדרת הטיימר למאוורר. | string ערכים: "מופעל", "מושבת" |
duration |
אופציונלי. ההגדרה קובעת את משך הזמן בשניות שהטיימר מוגדר לפעול. | string טווח: "1s" עד "43200s" ברירת מחדל: "900s" |
שגיאות
ניתן להחזיר את קודי השגיאה הבאים ביחס לתכונה הזו:
הודעת שגיאה | הכנסה לקליק | פתרון בעיות |
---|---|---|
מאוורר התרמוסטט לא זמין. | FAILED_PRECONDITION |
לתרמוסטט אין מאוורר. לא ניתן להשתמש בתכונות ובפקודות שקשורות למעריצים במכשיר הזה. |
בחומר העזר בנושא קוד שגיאה של API מופיעה הרשימה המלאה של קודי השגיאות של ה-API.