סכמת מעריצים

Nest Thermostat 

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.