אסור להשתמש ב-sdm.devices.types.device-type שמוחזר על ידי SDM API כדי להסיק או להסיק מסקנות לגבי הפונקציונליות של המכשיר בפועל שאליו הוא משויך. אין ערובה לכך שסוג המכשיר יישאר יציב במכשיר ספציפי ככל שנוסיף תכונות ל-SDM API. במקום זאת, צריך להשתמש במאפיינים שמוחזרים לגבי המכשיר.
parentRelations
אובייקט parentRelations מייצג את משאב ההורה של המשאב הנוכחי, מבנה או חדר. השם המוצג תואם לשדה customName שלInfo trait למכשירים עם הורה מבנה אוRoomInfo trait למכשירים עם הורה חדר.
פקודות
פקודות הן בקשות שמשויכות לתכונה. לדוגמה, שינוי המצב הנוכחי או נקודת הטמפרטורה שנקבעה בתרמוסטט Google Nest.
רוב התשובות לפקודה הן הצלחה או כישלון פשוטים. במדריכים של התכונות השונות יש דוגמאות ספציפיות לשימוש בפקודות.
אירועים
אירועים הם אסינכרוניים והם מנוהלים על ידי Google Cloud Pub/Sub בנושא יחיד לכל מזהה Project .
כברירת מחדל, אירועים נשלחים על כל שינוי בערך של שדה מאפיין. אפשר גם לשלוח אותן בתגובה לפעולות ספציפיות במכשיר או לשינויים בהקצאות של משאבים. מידע נוסף זמין במאמר בנושא אירועים.
[null,null,["עדכון אחרון: 2025-07-29 (שעון UTC)."],[[["\u003cp\u003eThe Smart Device Management API allows you to interact with Nest devices through traits, commands, and events.\u003c/p\u003e\n"],["\u003cp\u003eTraits represent device capabilities and their associated data, such as temperature or humidity, and are categorized by device type like Thermostat or Camera.\u003c/p\u003e\n"],["\u003cp\u003eCommands are used to control devices, for instance, changing the thermostat mode, while events provide asynchronous notifications about device state changes.\u003c/p\u003e\n"],["\u003cp\u003eYou can access device information and traits through a GET request to the specified API endpoint using the device ID.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud Pub/Sub manages events and delivers them to a dedicated topic for each project ID, allowing you to stay updated on device activity.\u003c/p\u003e\n"]]],[],null,[]]
