Google is committed to advancing racial equity for Black communities. See how.

ממשק 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

איפה_שם

שם התצוגה של המכשיר. משויך מצלמת Nest 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

סטטוס המצלמה, מופעל או זורם באופן פעיל או מושבת. ראה איך המצלמה שלך עובדת עם בית / חוץ 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 .

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

החלפה האחרונה_אינטרנט

חותם זמן המזהה את השינוי שעבר למעמד באינטרנט, ב 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

Nest 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

אזורי פעילות

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

איזורי פעילות משמשים לניטור אירועי תנועה בתוך אזורים המוגדרים על ידי המשתמש של הסרטון. דורש Nest Aware .

פרטים
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
החזרות array
דוגמה: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 הוא שם האזור, או שהוגדרו על ידי המשתמש או באופן אוטומטי על כשאזור נוצר.
string2 הוא מזהה המוקצה על ידי קן כאשר אזור הפעילות נוצר.
גִישָׁה לקריאה בלבד
אפשר להשיג ב מצלמת קריאה + תמונות / 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 לרדת מתחת ל -1080 p כאשר נוכח 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.

יש_צליל

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

פרטים
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

has_person

אירוע אדם - אדם זוהה.

פרטים
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 בפורמט, המזהה את התפוגה של כתובות אירוע הקשור הבאות:

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

דורש 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 . משמש להצגת האירוע שהוקלט האחרון ומחייב את המשתמש בכניסה לחשבון.

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

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

פרטים
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

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

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

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

פרטים
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

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

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

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

פרטים
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 שנלכד לאירוע קול או תנועה.

דורש Nest Aware .

פרטים
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

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

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

דורש Nest Aware . כאשר בשימוש עם 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