תכונות

מאפיין ב-SDM API כולל שדות, פקודות ואירועים.

כל הקריאות ל-SDM API צריכות להשתמש בנקודת הקצה הבאה:
https://smartdevicemanagement.googleapis.com/v1

שדות

שדות הם ערכים עם סוגי נתונים נפוצים, כמו מספר או מחרוזת. לדוגמה, שדה יכול להכיל את המצב הנוכחי או את הלחות הסביבתית של Google Nest Thermostat.

אפשר לראות את המאפיינים והשדות באמצעות קריאה ל-API לנקודת הקצה הרצויה:GET

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 שלInfo trait למכשירים עם הורה מבנה אוRoomInfo trait למכשירים עם הורה חדר.

פקודות

פקודות הן בקשות שמשויכות לתכונה. לדוגמה, שינוי המצב הנוכחי או נקודת הטמפרטורה שנקבעה בתרמוסטט Google Nest.

פקודה נשלחת על ידי קריאה ל-API של executeCommand:

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

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

אירועים

אירועים הם אסינכרוניים והם מנוהלים על ידי Google Cloud Pub/Sub בנושא יחיד לכל מזהה Project .

כברירת מחדל, אירועים נשלחים על כל שינוי בערך של שדה מאפיין. אפשר גם לשלוח אותן בתגובה לפעולות ספציפיות במכשיר או לשינויים בהקצאות של משאבים. מידע נוסף זמין במאמר בנושא אירועים.

קטגוריות של מאפיינים

מבנה

תכונות
פרטים	sdm.structures.traits.Info המאפיין הזה שייך לכל מבנה של מידע שקשור למבנה.
RoomInfo	sdm.structures.traits.RoomInfo המאפיין הזה שייך לכל חדר שרוצים להציג לגביו מידע שקשור לחדר.

מכשיר

תכונות
קישוריות	sdm.devices.traits.Connectivity המאפיין הזה שייך לכל מכשיר שיש בו מידע על קישוריות.
Fan	sdm.devices.traits.Fan המאפיין הזה שייך לכל מכשיר שיש לו את היכולת לשלוט במאוורר.
לחות	sdm.devices.traits.Humidity המאפיין הזה שייך לכל מכשיר שיש בו חיישן למדידת לחות.
פרטים	sdm.devices.traits.Info המאפיין הזה שייך לכל מכשיר שרוצים לקבל לגביו מידע שקשור למכשיר.
הגדרות	sdm.devices.traits.Settings המאפיין הזה שייך לכל מכשיר, למידע על הגדרות שקשורות למכשיר.
טמפרטורה	sdm.devices.traits.Temperature המאפיין הזה שייך לכל מכשיר שיש בו חיישן למדידת טמפרטורה.

תרמוסטט

תכונות
ThermostatEco	sdm.devices.traits.ThermostatEco המאפיין הזה שייך לסוגי מכשירים של THERMOSTAT שתומכים במצבי ECO.
ThermostatHvac	sdm.devices.traits.ThermostatHvac התכונה הזו שייכת לסוגי מכשירים של THERMOSTAT שיכולים לדווח על פרטים של מערכת בקרת אקלים.
ThermostatMode	sdm.devices.traits.ThermostatMode התכונה הזו שייכת לסוגי מכשירים של THERMOSTAT שתומכים במצבי תרמוסטט שונים.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint המאפיין הזה שייך לסוגי מכשירים של THERMOSTAT שתומכים בהגדרת טמפרטורת יעד וטווח טמפרטורות.

מצלמה

תכונות
CameraClipPreview	sdm.devices.traits.CameraClipPreview המאפיין הזה שייך לכל מכשיר שתומך בהורדה של תצוגה מקדימה של קליפ.
CameraEventImage	sdm.devices.traits.CameraEventImage התכונה הזו שייכת לכל מכשיר שתומך ביצירת תמונות מאירועים.
CameraImage	sdm.devices.traits.CameraImage התכונה הזו שייכת לכל מכשיר שתומך בצילום תמונות.
CameraLiveStream	sdm.devices.traits.CameraLiveStream המאפיין הזה שייך לכל מכשיר שתומך בסטרימינג בשידור חי.
CameraMotion	sdm.devices.traits.CameraMotion המאפיין הזה שייך לכל מכשיר שתומך באירועים של זיהוי תנועה.
CameraPerson	sdm.devices.traits.CameraPerson התכונה הזו שייכת לכל מכשיר שתומך באירועי זיהוי אנשים.
CameraSound	sdm.devices.traits.CameraSound התכונה הזו שייכת לכל מכשיר שתומך באירועים של זיהוי צלילים.

פעמון דלת

תכונות
DoorbellChime	sdm.devices.traits.DoorbellChime המאפיין הזה שייך לכל מכשיר שתומך בצליל של פעמון הדלת ובאירועים קשורים של לחיצה.