Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

Camera API

Nest API با همه مدل های Nest Cam کار می کند.

کاربران می توانند چندین Nest Nest را به حداکثر در هر ساختار به گروه devices/cameras اضافه کنند . وقتی با این مکان داده تماس می گیرید ، می توانید به داده های Nest Cam (مقادیر داده برای دستگاه های موجود در ساختار) دسترسی پیدا کنید.

تمام مقادیر زیر در زیر هر devices/cameras/ device_id در سند JSON یافت می شود.

شناسه دستگاه

شناسه منحصر به فرد 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

کجا

شناسه منحصر به فرد و ایجادشده توسط Nest که نشان دهنده name ، نام نمایشی دستگاه است.

درباره مکان نام Nest Thermostats ،Nest Protects و Nest Cams بیشتر بدانید.

جزئیات
https://developer-api.nest.com/devices/cameras/ device_id /where_id
برمی گردد string
مثال: "d6reb_OZTM ..."
دسترسی فقط خواندنی
قابل دسترسی در خواندن دوربین / v1-v3
خواندن دوربین + تصاویر / v1-v4
خواندن / نوشتن دوربین / v1-v3
خواندن / نوشتن دوربین + تصاویر / v1-v4

اسم_جای

نام نمایشگر دستگاه مرتبط با Nest Cam where_id . می تواند هر نام اتاق از لیستی که ما ارائه می دهیم یا یک نام سفارشی باشد. درباره مکان نام Nest Thermostats ،Nest Protects و Nest Cams بیشتر بیاموزید.

جزئیات
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
مثال: "Hallway Nest Cam (طبقه بالا)"
دسترسی فقط خواندنی
قابل دسترسی در خواندن دوربین / 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

جریان است

وضعیت دوربین ، یا فعال و یا پخش مستقیم فیلم ، یا خاموش. برای اطلاعات بیشتر به نحوه کار دوربین شما با Home / Away Assist مراجعه کنید.

جزئیات
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
برمی گردد boolean
ارزش ها: درست ، نادرست
دسترسی بخوان / بنویس
قابل دسترسی در خواندن دوربین / v1-v3
خواندن دوربین + تصاویر / v1-v4
خواندن / نوشتن دوربین / v1-v3
خواندن / نوشتن دوربین + تصاویر / v1-v4

ورودی_صوتی_قابل فعال است

وضعیت میکروفون دوربین ، روشن یا گوش دادن ، یا خاموش. درباره تنظیمات صوتی Nest Cam بیشتر بدانید.

جزئیات
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

تاریخ_ویدئو_قابل فعال است

وضعیت اشتراک 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

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

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

اشتراک_نمایشی_عامل امکان پذیر است

کاربران می توانند ویدیوی خود را به اشتراک بگذارند و توسط همه قابل مشاهده باشند. وقتی اشتراک عمومی فعال است ، می توانید 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 شناسه ای است که هنگام ایجاد Activity Zone توسط Nest اختصاص داده شده است.
دسترسی فقط خواندنی
قابل دسترسی در خواندن دوربین + تصاویر / v3-v4
خواندن / نوشتن دوربین + تصاویر / v3-v4

اشتراک_همگانی_همگانی

وقتی کاربری جریان ویدیوی خود را عمومی کند ، می توانید به این 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

تصویری را به درخواست خود ثبت کنید. URL تصویری را که از جریان مستقیم ویدئو گرفته شده است برمی گرداند. نیاز به روشن بودن و فعال بودن دوربین دارد.

از این قسمت برای گرفتن عکس فوری از جریان مستقیم ویدئو استفاده کنید.

  • snapshot_url - URL تصویری که از جریان ویدئو زنده گرفته شده است را برمی گرداند
  • نیاز به روشن بودن و فعال بودن دوربین دارد

در صورت وجود کیفیت عکس فوری از API تنها 1080p است:

  • مشاهده فعال جریان دوربین در برنامه ( web_url )
  • مشاهده فعال جریان عمومی ( app_url )
  • در Nest Aware مشترک شده اید

اگر به طور فعال جریان را مشاهده نمی کنید یا اشتراک Nest Aware ندارید ، API منبع 1080p ندارد که بتواند عکس فوری را با آن وضوح بازیابی کند و تصویری با کیفیت پایین تولید می کند. همچنین ، پهنای باند شبکه محلی محلی ممکن است باعث شود که وضوح تصویر API با وجود Nest Aware به زیر 1080p برسد.

درباره نیازهای پهنای باند برای دوربین های Nest بیشتر بدانید.

بسته به وضعیت اشتراک 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

has_motion دارد

رویداد حرکت - حرکت شناسایی شد.

جزئیات
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 ، تاریخ انقضا این URL های مربوط به رویداد را مشخص می کند:

زمان انقضا به این صورت محاسبه می شود: last_event/start_time + n روز (که n = 10 یا 30 روز بستگی دارد ، بسته به برنامه اشتراک Nest 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

URL وب (پیوند عمیق) به آخرین رویداد صدا یا حرکت در home.nest.com . برای نمایش آخرین رویداد ضبط شده استفاده می شود و کاربر باید به سیستم وارد حساب شود.

به Nest Aware نیاز دارد. اگر نشانی اینترنتی رویداد منقضی شده باشد یا دستگاه اشتراک فعال نداشته باشد ، این مقدار در بارگیری وارد نمی شود.

برای اطلاعات در مورد زمان انقضا این URL به 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

URL برنامه Nest (پیوند عمیق) به آخرین رویداد صدا یا حرکت. برای نمایش آخرین رویداد ضبط شده استفاده می شود و کاربر باید به سیستم وارد حساب شود.

به Nest Aware نیاز دارد. اگر نشانی اینترنتی رویداد منقضی شده باشد یا دستگاه اشتراک فعال نداشته باشد ، این مقدار در بارگیری وارد نمی شود.

برای اطلاعات در مورد زمان انقضا این 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

image_url

URL (پیوند) به پرونده تصویری گرفته شده برای یک رویداد صدا یا حرکت.

به Nest Aware نیاز دارد. برای اطلاعات در مورد زمان انقضا این URL به 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

anim__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