ממשק API למצלמה

ממשק API של Nest עובד עם כל דגמי Nest Cam ™.

משתמשים יכולים להוסיף מצלמות קן מרובות לקבוצת devices/cameras , עד למקסימום לכל מבנה . כשאתה מתקשר למיקום נתונים זה, אתה יכול לגשת לנתוני Nest Cam (ערכי נתונים עבור מכשירים במבנה).

כל הערכים שלהלן נמצאים תחת כל devices/cameras/ device_id במסמך JSON.

device_id

מזהה ייחודי של Nest Cam.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /device_id
החזרות	string דוגמה: "awJo6rH ..."
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

גרסת תוכנה

גרסת תוכנה.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /software_version
החזרות	string דוגמה: "4.0"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

מבנה_יד

מבנה מזהה ייחודי.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
החזרות	string דוגמה: "VqFabWH21nw ..."
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

איפה

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

למידע נוסף על המקומות שבהם שמות עבור תרמוסטטים של קן , מגן על קנים ומצלמות קן .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /where_id
החזרות	string דוגמה: "d6reb_OZTM ..."
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

איפה

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

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /where_name
החזרות	string דוגמה: "מסדרון"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v3 מצלמה קוראת + תמונות / v4 מצלמה קריאה / כתיבה / v3 מצלמה קוראת / כותבת + תמונות / v4

שֵׁם

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

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /name
החזרות	string דוגמה: "מסדרון"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

שם_אורך

שם תצוגה ארוך של המכשיר. כולל התאמה אישית (תווית), שנוצרה על ידי המשתמש או באמצעות wheres .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /name_long
החזרות	string דוגמה: "מצלמת המסדרון של קן המסדרון (למעלה)"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

מחובר

סטטוס חיבור מכשיר עם שירות Nest.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /is_online
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

is_streaming

סטטוס המצלמה, או בווידיאו זורם או פעיל, או כבוי. ראה כיצד המצלמה שלך עובדת עם Home / Away Assist למידע נוסף.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	קרוא וכתוב
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

is_audio_input_enabled

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

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

last_is_online_change

חותמת זמן המזהה את השינוי האחרון בסטטוס המקוון, בפורמט ISO 8601 .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
החזרות	string דוגמה: "2016-12-29T18: 42: 00.000Z"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

is_video_history_enabled

סטטוס המנוי לקן Aware (המנוי פעיל או לא).

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

web_url

כתובת אתר אינטרנט (קישור עמוק) לזרם הווידיאו החי בכתובת home.nest.com .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /web_url
החזרות	string דוגמה: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

app_url

כתובת אתר של אפליקציה (קישור עמוק) לזרם הווידיאו החי באפליקציית Nest.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /app_url
החזרות	string דוגמה: " nestmobile://cameras/ device_id ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

is_public_share_enabled

משתמשים יכולים לבחור לשתף את הווידאו שלהם ולהפוך אותו לצפייה על ידי כל אחד. כאשר השיתוף הציבורי מופעל, אתה יכול לקרוא public_share_url .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v3-v4 מצלמה קוראת / כותבת + תמונות / v3-v4

אזורי פעילות

מחזירה מערך של כל אזורי הפעילות שהוגדרו.

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

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
החזרות	array דוגמה: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 הוא שם האזור, מוגדר על ידי המשתמש או שנוצר אוטומטית בעת יצירת האזור. • string2 הוא מזהה שהוקצה על ידי Nest כאשר נוצר אזור הפעילות.
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v3-v4 מצלמה קוראת / כותבת + תמונות / v3-v4

public_share_url

אתה יכול לגשת לכתובת אתר זו כאשר משתמש הופך את זרם הווידאו שלו לציבורי .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
החזרות	string דוגמה: " https://video.nest.com/live/ string1 ? string2 " string1 הוא שם זרם הווידיאו, מוגדר על ידי המשתמש או שנוצר אוטומטית כאשר הזרם מוגדר לציבורי.
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v3-v4 מצלמה קוראת / כותבת + תמונות / v3-v4

snapshot_url

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

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

• snapshot_url - מחזירה את כתובת האתר של תמונה שנלכדה מזרם הווידיאו החי
• דורש שהמצלמה פועלת ומוזרמת באופן פעיל

איכות תמונת המצב מממשק ה- API היא תפוקת 1080p בלבד אם אתה:

• צפייה אקטיבית בזרם המצלמה ביישום ( web_url )
• צפייה פעילה בזרם הציבורי ( app_url )
• נרשם ל- Nest Aware

אם אינך צופה בזרם באופן פעיל או שאין לך מנוי ל- Nest Aware, ל- API אין מקור 1080p ממנו ניתן לאחזר תמונת מצב ברזולוציה זו ומייצר תמונה באיכות נמוכה יותר. כמו כן רוחב הפס המקומי הנמוך עלול לגרום לרזולוציית תמונת המצב של API לטבול מתחת ל 1080p כאשר Nest Aware קיים.

למידע נוסף על דרישות רוחב פס למצלמות קן .

מגבלות תעריף חלות על שיחה זו, בהתאם למצב המנוי של Nest Aware.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
החזרות	string דוגמה: " string1 / device_id / string2 ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v3-v4 מצלמה קוראת / כותבת + תמונות / v3-v4

אירוע אחרון

אובייקט זה לוכד מידע על האירוע האחרון שהפעיל הודעה.

חלק מהשדות ושילובי הרשאות מסוימים דורשים מנוי ל- Nest Aware כדי לגשת למידע על האירועים האחרונים.

כל הערכים מתחת נמצאות תחת כל devices/cameras/ device_id /last_event במסמך JSON.

has_ound

אירוע צליל - זוהה צליל.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

יש_רגש

אירוע תנועה - התגלה תנועה.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

יש_ אישי

אירוע אדם - אדם התגלה.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
החזרות	boolean ערכים: נכון, שקר
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

שעת התחלה

זמן התחלת אירוע, בפורמט ISO 8601 .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
החזרות	string דוגמה: "2016-12-29T00: 00: 00.000Z"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

זמן סיום

זמן סיום אירוע, בפורמט ISO 8601 .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
החזרות	string דוגמה: "2016-12-29T00: 00: 00.000Z"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

urls_expire_time

חותמת זמן, בפורמט ISO 8601 , המזהה את תפוגה של כתובות URL אלה הקשורות לאירועים:

• last_event/web_url
• last_event/app_url
• last_event/image_url
• last_event/animated_image_url

זמן התפוגה מחושב כ- last_event/start_time + n ימים (כאשר n = 10 או 30 יום, תלוי בתוכנית המנוי של Nest Aware).

דורש קן מודע .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
החזרות	string דוגמה: "2016-12-29T00: 00: 00.000Z"
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

web_url

כתובת אתר אינטרנט (קישור עמוק) לאירוע הצליל או התנועה האחרון באתר home.nest.com . משמש להצגת האירוע שהוקלט האחרון ומחייב את המשתמש להיכנס לחשבון.

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

ראה last_event/urls_expire_time למידע על זמן התפוגה של כתובת אתר זו.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
החזרות	string דוגמה: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

app_url

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

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

ראה last_event/urls_expire_time למידע על זמן התפוגה של כתובת אתר זו.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
החזרות	string דוגמה: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	קריאת מצלמה / v1-v3 מצלמה קוראת + תמונות / v1-v4 מצלמה קריאה / כתיבה / v1-v3 מצלמה קוראת / כותבת + תמונות / v1-v4

כתובת אתר של תמונה

כתובת אתר (קישור) לקובץ התמונה שצולם לצורך אירוע קול או תנועה.

דורש קן מודע . ראה last_event/urls_expire_time למידע על זמן התפוגה של כתובת אתר זו.

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
החזרות	string דוגמה: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v1-v4 מצלמה קוראת / כותבת + תמונות / v1-v4

animated_image_url

URL (קישור) לקובץ ה- GIF שנלכד לאירוע צליל או תנועה.

דורש קן מודע .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
החזרות	string דוגמה: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v1-v4 מצלמה קוראת / כותבת + תמונות / v1-v4

פעילות_אזור_ידס

מזהים לאזורי פעילות שגילו אירוע תנועה.

דורש קן מודע . כאשר בשימוש עם activity_zones מערך, אתה יכול לקבל את שם האזור מזיהויי אלה.

אם last_event/has_motion הוא

• true = מחזיר את מזהי אזור הפעילות שזיהו אירוע תנועה
• false = מחזיר מערך ריק

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
החזרות	array דוגמה: [ string1 , string2 ,... ]
גִישָׁה	לקריאה בלבד
זמין ב	מצלמה קוראת + תמונות / v3-v4 מצלמה קוראת / כותבת + תמונות / v3-v4