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 مع جميع طرازات Nest Cam ™.

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

where_id

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

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

تفاصيل
https://developer-api.nest.com/devices/cameras/ device_id /where_name
عائدات string
مثال: "مدخل"
وصول يقرأ فقط
متوفر في قراءة الكاميرا / v3.0
قراءة الكاميرا + الصور / v4.2
قراءة الكاميرا / الكتابة / v3.0
قراءة / كتابة الكاميرا + صور / v4.0

اسم

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

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

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 لصورة تم التقاطها من دفق الفيديو المباشر
  • يتطلب أن تكون الكاميرا قيد التشغيل وتدفق بشكل نشط

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

  • مشاهدة دفق الكاميرا بنشاط في التطبيق ( 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

شخص

حدث شخص - تم اكتشاف شخص.

تفاصيل
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 days (حيث 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

Activity_zone_ids

معرفات مناطق النشاط التي اكتشفت حدثًا متحركًا.

يتطلب 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