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

Smoke + CO Alarm API

تعمل واجهة برمجة التطبيقات (API) مع جميع طرازات Nest Protect ™ الدخان + أول أكسيد الكربون.

يمكن للمستخدمين إضافة العديد من Nest devices/smoke_co_alarms مجموعة devices/smoke_co_alarms ، حتى الحد الأقصى لكل هيكل . عند إجراء اتصال بموقع البيانات هذا ، يمكنك الوصول إلى بيانات Nest Protect (قيم البيانات للأجهزة الموجودة في الهيكل).

تم العثور على جميع القيم أدناه أسفل كل devices/smoke_co_alarms/ device_id في مستند JSON.

device_id

معرّف Nest Protect الفريد.

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /device_id
عائدات string
مثال: "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

اللغة

يحدد تفضيلات اللغة والمنطقة (أو البلد).

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /locale
عائدات string
أمثلة: "en-GB" و "en-US" و "es-US" و "fr-CA" و "fr-CA" و "nl-NL"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

نسخة البرمجيات

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

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /software_version
عائدات string
مثال: "1.0.1"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

معرّف_هيكل

المعرف الفريد للهيكل.

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /structure_id
عائدات string
مثال: "VqFabWH21nw ..."
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

اسم

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

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name
عائدات string
مثال: "ممر"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

name_long

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

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name_long
عائدات string
مثال: "حماية المدخل (الطابق العلوي)"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

الاتصال الأخير

الطابع الزمني لآخر تفاعل ناجح مع خدمة Nest بتنسيق ISO 8601 .

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_connection
عائدات string
مثال: "2016-12-31T23: 59: 59.000Z"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

متصل

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

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_online
عائدات boolean
القيم: صحيح ، خطأ
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

صحة البطارية

عمر البطارية / الصحة ؛ تقدير مستوى طاقة البطارية المتبقية.

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /battery_health
عائدات string enum
القيم: "ok" و "replace"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

co_alarm_state

حالة إنذار أول أكسيد الكربون (CO).

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /co_alarm_state
عائدات string enum
القيم: "موافق" ، "تحذير" ، "طوارئ"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

دخان_الارم

حالة إنذار الدخان.

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /smoke_alarm_state
عائدات string enum
القيم: "موافق" ، "تحذير" ، "طوارئ"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

is_manual_test_active

حالة اختبار الدخان اليدوي وإنذار أول أكسيد الكربون.

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_manual_test_active
عائدات boolean
القيم: صحيح ، خطأ
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v2-v5

last_manual_test_time

الطابع الزمني لآخر اختبار يدوي للإنذار بدخان الدخان وأول أكسيد الكربون بتنسيق ISO 8601 .

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_manual_test_time
عائدات string
مثال: "2016-12-31T23: 59: 59.000Z"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v2-v5

ui_color_state

يشير إلى حالة الجهاز حسب اللون في واجهة مستخدم تطبيق Nest. وهي حالة مجمعة لحالات البطارية + الدخان + CO ، وتعكس مؤشرات الألوان الفعلية المعروضة في تطبيق Nest.

لمزيد من المعلومات حول مؤشرات الألوان ، راجع مصابيح Nest Protect ومستوى بطارية Nest Protect .

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /ui_color_state
عائدات string enum
القيم: "رمادي" ، "أخضر" ، "أصفر" ، "أحمر"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v1-v5

حيث

معرّف فريد من نوعه يتم إنشاؤه بواسطة Nest يمثل name العرض للجهاز.

تعرف على مزيد من المعلومات حول مكان أسماء Nest Thermostats و Nest Protects و Nest Cams .

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_id
عائدات string
مثال: "d6reb_OZTM ..."
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v3-v5

where_name

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

تفاصيل
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_name
عائدات string
مثال: "ممر"
التمكن من يقرأ فقط
متوفر في Smoke + CO read / v5