סכימת פעמון פעמון

Nest Doorbell (מדור קודם) Nest Doorbell (סוללה) Nest Doorbell (עם חיבור קווי) 

sdm.devices.traits.DoorbellChime

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

שדות

אין שדות זמינים לתכונה הזו.

פקודות

אין פקודות זמינות לתכונה הזו.

אירועים

צלצול פעמונים

ניתן לעדכון 

פעמון הדלת נלחץ.

האירוע הזה תומך בהתראות הניתנות לעדכון. ניתן לעדכן התראות קיימות מהאפליקציה שנוצרו מהאירוע הזה באמצעות התוכן של אירוע עתידי עם אותו eventThreadId.

אירוע צלצול

מטען ייעודי (Payload)

{
  "eventId" : "854a3723-c351-45df-95e9-aed6004c1352",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "mq-qjzq6wgrOPERrPw7OMmBZPN..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

שדות של אירועי צלצול

שדה תיאור סוג הנתונים
eventSessionId Nest Doorbell (סוללה) Nest Doorbell (עם חיבור קווי) מזהה שניתן לאירועים שמתרחשים כחלק מסשן יחיד של אירועים קשורים. יכול לשמש לאיחוד אירועים.

צריך להשתמש בה כדי לשייך את האירוע הזה לאירוע ClipPreview שקשור ל-trait של CameraClipPreview.

 string
דוגמה: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Doorbell (מדור קודם) מזהה שמשויך לאירוע.

אפשר להשתמש בה עם הפקודה GenerateImage כדי להוריד את תמונת המצלמה שקשורה לאירוע הזה.

 string
דוגמה: "mq-qjzq6wgrOPERrPw7OMmBZPN..."

שדות המטען הייעודי (payload) של אירועים

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
דוגמה: "854a3723-c351-45df-95e9-aed6004c1352"
timestamp השעה שבה התרחש האירוע. string
לדוגמה: "2019-01-01T00:00:01Z"
resourceUpdate אובייקט עם פרטים על עדכון המשאב. object
userId מזהה ייחודי ומעורפל שמייצג את המשתמש. string
דוגמה: AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi'
eventThreadId ניתן לעדכון המזהה הייחודי של שרשור האירוע. string
דוגמה: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState ניתן לעדכון המצב של שרשור האירוע. string
ערכים: 'STARTED', 'UPDATED', 'ENDED'
resourceGroup אובייקט שמציין משאבים שעשויים לכלול עדכונים דומים לאירוע הזה. המשאב של האירוע עצמו (מהאובייקט resourceUpdate) תמיד יופיע באובייקט הזה. object

בקטע אירועים אפשר לקרוא מידע נוסף על סוגי האירועים השונים ועל אופן הפעולה שלהם.

שגיאות

ניתן להחזיר את קודי השגיאה הבאים ביחס לתכונה הזו:

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

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