Google متعهد به پیشبرد برابری نژادی برای جوامع سیاه است. ببینید چگونه.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

API دوربین

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

کاربران می توانند تا حداکثر ساختار در هر devices/cameras چندین devices/cameras لامپ را به گروه 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

کجا

شناسه منحصر به فرد و تولید شده توسط لانه که نشان دهنده 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

Where_name

نام صفحه نمایش دستگاه. با Nest Nest کام 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

name_long

نام نمایشگر طولانی دستگاه. شامل یک سفارشی (برچسب) است که توسط کاربر یا از طریق 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

Timestamp که آخرین تغییر وضعیت آنلاین را با فرمت 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

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

هنگامی که کاربر جریان ویدیوی خود را عمومی کند ، می توانید به این 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 را ندارید ، API هیچ منبع 1080p ندارد که بتواند عکس فوری را در آن وضوح بگیرد و تصویری با کیفیت پایین تولید کند. همچنین پهنای باند شبکه محلی ممکن است باعث شود وضوح تصویر فوری API زیر 1080p با Nest Aware موجود نباشد.

درباره الزامات پهنای باند برای دوربین های 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

last_event

این شی اطلاعات مربوط به آخرین واقعه ای که باعث یک اعلان شده است ، ضبط می کند.

برخی از قسمتها و برخی از مجوزها برای دسترسی به آخرین اطلاعات رویداد ، نیاز به اشتراک Nest Aware دارند.

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

has_sound

رویداد صدا - صدا تشخیص داده شد.

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

Timestamp ، با فرمت ISO 8601 ، منقضی شدن این URL های مربوط به رویداد:

زمان انقضا به شرح زیر است: last_event/start_time + n (جایی که بسته به برنامه اشتراک Nest Aware بستگی به 10 یا 30 روز دارد).

به آشیانه آگاهی نیاز دارد.

جزئیات
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 . برای نمایش آخرین رویداد ضبط شده استفاده می شود و به کاربر نیاز دارد تا وارد حساب شوید.

به آشیانه آگاهی نیاز دارد. اگر نشانی اینترنتی رویداد منقضی شده یا دستگاه اشتراک مشترک نداشته باشد ، این مقدار در بارگذاری گنجانده نشده است.

برای اطلاعات در مورد زمان انقضا این 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 ، به 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 (پیوند) به پرونده تصویری که برای یک رویداد صوتی یا حرکتی ضبط شده است.

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

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_zone_ids

شناسه های فعالیت های منطقه که یک رویداد حرکتی را شناسایی کردند.

به آشیانه آگاهی نیاز دارد. هنگامی که با استفاده 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