סכימה של מעריצים

Nest Thermostat 

sdm.devices.traits.Fan

המאפיין הזה שייך לכל מכשיר שיש למערכת אפשרות לשלוט בו.

שדות

שדה תיאור סוג הנתונים
timerMode מצב הטיימר הנוכחי. string
ערכים: ON,‏ OFF
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
ערכים: ON,‏ OFF
duration אופציונלי. משך הזמן בשניות שבו הטיימר מוגדר לפעול. string
טווח: ‎"1s" עד "43200s"
ברירת מחדל: ‎"900s"

שגיאות

ייתכן שתקבלו את קודי השגיאה הבאים בנוגע למאפיין הזה:

הודעת השגיאה הכנסה לקליק פתרון בעיות
המאוורר של התרמוסטט לא זמין. FAILED_PRECONDITION לתרמוסטט אין יכולת להפעיל מאוורר. אי אפשר להשתמש במכשיר הזה בתכונות ובפקודות שקשורות למעריצים.

בחומר העזר בנושא קודי שגיאה ב-API מופיעה רשימה מלאה של קודי השגיאה ב-API.