واجهة برمجة تطبيقات الكاميرا

تعمل واجهة برمجة تطبيقات Nest مع جميع طُرز Nest CamTM.

يمكن للمستخدمين إضافة منتجات 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..."
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

Software_version

إصدار البرنامج.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/software_version
المرتجعاتstring
مثال: "4.0"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

معرّف_البنية

بنية المعرّف الفريد

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/structure_id
المرتجعاتstring
مثال: "VqFabWH21nw..."
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

حيث_id

هو معرّف فريد من إنشاء Nest يمثّل name، وهو الاسم المعروض للجهاز.

تعرّف على مزيد من المعلومات حول أماكن استخدام أجهزة Nest Thermostat وNest Protects وNest Cams.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/where_id
المرتجعاتstring
مثال: "d6reb_OZTM..."
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

حيث_الاسم

الاسم المعروض للجهاز. مرتبط بكاميرا Nest where_id. يمكن أن يكون أي اسم غرفة من قائمة نقدمها، أو اسمًا مخصصًا. تعرّف على مزيد من المعلومات حول أماكن استخدام أجهزة Nest Thermostat وNest Protects وNest Cams.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/where_name
المرتجعاتstring
مثال: "Hallway"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 3
قراءة الكاميرا + الصور / الإصدار 4
قراءة/كتابة الكاميرا / الإصدار 3
الكاميرا للقراءة/الكتابة + الصور / الإصدار 4

الاسم

الاسم المعروض للجهاز، ويمكن أن يتمثل في أي اسم غرفة من قائمة نقدمها، أو اسم مخصّص.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/name
المرتجعاتstring
مثال: "Hallway"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

name_long

الاسم المعروض الطويل للجهاز تتضمن (تصنيفًا) مخصصًا تم إنشاؤه بواسطة المستخدم أو عبر wheres.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/name_long
المرتجعاتstring
مثال: "Hallway Nest Cam (UPsairs)"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

is_online

حالة اتصال الجهاز بخدمة Nest.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/is_online
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

is_streaming

للتعرّف على حالة الكاميرا، سواء تمّ تفعيل الفيديو أو بثّه مباشرةً أو إيقافه، يمكنك الاطّلاع على مزيد من المعلومات حول آلية عمل الكاميرا مع "داخل المنزل/خارج المنزل".

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولالقراءة/الكتابة
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

is_audio_input_enabled

حالة ميكروفون الكاميرا، سواء تم التشغيل أو الاستماع أو الإيقاف. يمكنك الاطّلاع على المزيد من المعلومات حول إعدادات الصوت في Nest Cam.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

تاريخ_آخر_ظهور_على_الإنترنت

الطابع الزمني الذي يحدّد آخر تغيير تم إجراؤه على الحالة على الإنترنت، بتنسيق ISO 8601.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change
المرتجعاتstring
مثال: "2016-12-29T18:42:00.000Z"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

is_video_history_enabled

حالة اشتراك Nest Aware (الاشتراك نشط أو لا).

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-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"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

app_url

عنوان URL للتطبيق (رابط لصفحة في التطبيق) للبث المباشر للفيديو في تطبيق Nest

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/app_url
المرتجعاتstring
مثال: "nestmobile://cameras/device_id?auth=camera_token"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

is_public_share_enabled

يمكن للمستخدمين اختيار مشاركة الفيديو الخاص بهم وجعله متاحًا لأي شخص. عند تفعيل المشاركة العلنية، يمكنك الاطّلاع على public_share_url.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا + الصور / الإصدار 3-v4
قراءة/كتابة + الكاميرا/الصور / الإصدار 3-v4

النشاط_المناطق

لعرض مصفوفة من جميع مناطق النشاط المحددة.

تُستخدم مناطق النشاط لمراقبة أحداث الحركة داخل المناطق التي يحدّدها المستخدم لبث الفيديو. يجب تفعيل Nest Aware.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/activity_zones
المرتجعاتarray
مثال: [ {"name" : "string1", "id" : "string2"},... ]

string1 هو اسم المنطقة، سواء من تحديد المستخدم أو الذي تم إنشاؤه تلقائيًا عند إنشاء المنطقة.
string2 هو معرّف تحدده Nest عند إنشاء منطقة النشاط.
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا + الصور / الإصدار 3-v4
قراءة/كتابة + الكاميرا/الصور / الإصدار 3-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 هو اسم بث الفيديو، سواءً من تحديد المستخدم أو الذي يتم إنشاؤه تلقائيًا عندما يتم ضبط البث على "علني".
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا + الصور / الإصدار 3-v4
قراءة/كتابة + الكاميرا/الصور / الإصدار 3-v4

لقطة_عنوان URL

التقِط صورة عند الطلب. لعرض عنوان URL لصورة تم التقاطها من بث الفيديو المباشر. يتطلب أن تكون الكاميرا مشغّلة وتبث المحتوى بشكل نشط.

استخدِم هذا الحقل للحصول على نبذة من بث الفيديو المباشر.

  • snapshot_url - لعرض عنوان URL لصورة تم التقاطها من بث الفيديو المباشر
  • تتطلّب أن تكون الكاميرا مشغَّلة وتبث المحتوى بشكلٍ نشط

لا تكون جودة لقطة الشاشة من واجهة برمجة التطبيقات سوى 1080p سرعة معالجة البيانات في الحالات التالية:

  • عرض البث المباشر للكاميرا في التطبيق (web_url)
  • عرض البث العلني بشكل نشط (app_url)
  • تم الاشتراك في خدمة Nest Aware

إذا لم تكن تشاهد البث بشكل نشط أو لم تكن مشتركًا في خدمة Nest Aware، لا تحتوي واجهة برمجة التطبيقات على مصدر بدقة 1080p يمكن الحصول من خلاله على نبذة عند استخدام درجة الدقة هذه وإنشاء صورة ذات جودة أقل. وقد يؤدي أيضًا انخفاض معدل نقل البيانات للشبكة المحلية إلى انخفاض دقة لقطة واجهة برمجة التطبيقات إلى أقل من 1080 بكسل مع ظهور Nest Aware.

تعرّف على مزيد من المعلومات حول متطلبات معدل نقل البيانات لكاميرات Nest.

تنطبق حدود الأسعار على هذه المكالمة، بناءً على حالة الاشتراك في Nest Aware.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
المرتجعاتstring
مثال: يتم استخدام &"string1/device_id/string2?auth=camera_token"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا + الصور / الإصدار 3-v4
قراءة/كتابة + الكاميرا/الصور / الإصدار 3-v4

حدث_آخر

يلتقط هذا العنصر معلومات حول الحدث الأخير الذي أدى إلى إرسال إشعار.

تتطلّب بعض الحقول وبعض مجموعات الأذونات اشتراكًا في Nest Aware للوصول إلى معلومات الحدث الأخير.

تتوفّر جميع القيم الواردة أدناه ضمن كل devices/cameras/device_id/last_event في مستند JSON.

تحتوي على صوت

حدث صوتي - تم رصد صوت

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

تحتوي على_حركة

حدث الحركة - تم رصد حركة.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

تحتوي على شخص

حدث شخص - تم رصد شخص.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
المرتجعاتboolean
القيم: صحيح، خطأ
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

وقت_البدء

وقت بدء الحدث بتنسيق ISO 8601.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
المرتجعاتstring
مثال: "2016-12-29T00:00:00.000Z"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

وقت_الانتهاء

تمثّل هذه السمة وقت انتهاء الحدث بتنسيق ISO 8601.

التفاصيل
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
المرتجعاتstring
مثال: "2016-12-29T00:00:00.000Z"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

url_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"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

web_url

عنوان URL على الويب (رابط لصفحة في التطبيق) لآخر حدث صوتي أو حركة على home.nest.com. يُستخدم هذا الإعداد لعرض آخر حدث مسجّل ويتطلب تسجيل دخول المستخدم إلى الحساب.

يجب تفعيل Nest Aware. إذا انتهت صلاحية عنوان URL للحدث أو لم يكن للجهاز اشتراك نشط، لا يتم تضمين هذه القيمة في الحمولة.

يمكنك الاطّلاع على 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"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

app_url

عنوان URL لتطبيق Nest (رابط لصفحة في التطبيق) لآخر حدث صوتي أو حدث حركة. يُستخدم لعرض آخر حدث مسجّل، ويتطلب تسجيل المستخدم للدخول إلى الحساب.

يجب تفعيل Nest Aware. إذا انتهت صلاحية عنوان URL للحدث أو لم يكن للجهاز اشتراك نشط، لا يتم تضمين هذه القيمة في الحمولة.

يمكنك الاطّلاع على 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"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا / الإصدار 1-v3
قراءة الكاميرا + صور / الإصدار 1-v4
قراءة/كتابة الكاميرا / الإصدار 1-v3
قراءة/كتابة + صور / الإصدار 1-v4

image_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"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا والصور / الإصدار 1-v4
قراءة/كتابة + الصور / الإصدار 1-v4

متحرك_صورة_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"
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا والصور / الإصدار 1-v4
قراءة/كتابة + الصور / الإصدار 1-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,... ]
الوصولللقراءة فقط
متوفّر فيقراءة الكاميرا + الصور / الإصدار 3-v4
قراءة/كتابة + الكاميرا/الصور / الإصدار 3-v4