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

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

يعمل Nest API مع جميع موديلات Nest Cam ™.

يمكن للمستخدمين إضافة عدة كاميرات Nest إلى مجموعة 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

حيث

معرّف فريد من نوعه يتم إنشاؤه بواسطة 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

where_name

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

تفاصيل
https://developer-api.nest.com/devices/cameras/ device_id /where_name
عائدات string
مثال: "ممر"
التمكن من يقرأ فقط
متوفر في قراءة الكاميرا / الإصدار 3
قراءة الكاميرا + صور / v4
قراءة / كتابة الكاميرا / الإصدار 3
قراءة / كتابة الكاميرا + صور / 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
مثال: "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

is_stream

حالة الكاميرا ، إما تشغيل الفيديو وبثه بنشاط ، أو إيقاف تشغيله. انظر كيف تعمل الكاميرا مع مساعد المنزل / بالخارج لمزيد من المعلومات.

تفاصيل
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

حالة اشتراك 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

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 عبارة عن معرف يتم تعيينه بواسطة 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

التقاط صورة عند الطلب. إرجاع عنوان URL لصورة تم التقاطها من دفق الفيديو المباشر. يتطلب تشغيل الكاميرا وبثها بنشاط.

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

  • snapshot_url - إرجاع عنوان URL لصورة تم التقاطها من دفق الفيديو المباشر
  • يتطلب تشغيل الكاميرا وبثها بنشاط

جودة اللقطة من واجهة برمجة التطبيقات هي إنتاجية 1080p فقط إذا كنت:

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

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

الحدث الأخير

يلتقط هذا الكائن معلومات حول الحدث الأخير الذي أثار إشعارًا.

تتطلب بعض الحقول وبعض تركيبات الأذونات اشتراك 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

الطابع الزمني بتنسيق 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 للحصول على معلومات حول وقت انتهاء عنوان 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

عنوان 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 "
التمكن من يقرأ فقط
متوفر في قراءة الكاميرا / 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