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 الوصول إلى البيانات التالية على مستوى الهيكل ، اعتمادًا على مستوى الأذونات الممنوحة:

  • اسم الهيكل والجهاز "حيث الاسم" (الموقع في المنزل)
  • قائمة الأجهزة في المنزل
  • حالة حدث الطاقة ( ساعة اندفاع الطاقة )
  • الدولة البعيدة
  • المستخدم ايتا
  • الدولة الأمنية
  • الرمز البريدي أو البريدي

يتم تغطية بعض الميزات على مستوى الهيكل في أدلة API منفصلة وأكثر تفصيلاً:

أذونات الهيكل

للوصول إلى ... تحديد...
معظم قيم البيانات في كائن structures أذونات Away أو ETA أو Energy أو الرمز البريدي
قيمة بيانات name في كائن structures إذن القراءة / الكتابة هيكل

تعرف على كيفية عمل الأذونات في مرجع API التفاعلي .

معرفات الهيكل

اسم

يتم تعيين اسم الهيكل افتراضيًا على "المنزل" ولكن يمكن أن يكون أي سلسلة يختارها المستخدم. عند اختيار إذن بنية القراءة / الكتابة ، يمكنك تغيير name الهيكل.

اين

wheres يتم تعيين كائن على بنية ، حيث تحتوي على معرفات حيث (حيث where_id name ). استخدم wheres إنشاء أسماء مخصصة ، أو الوصول إلى أسماء قياسية.

يتطلب الوصول إلى موقع الكائن wheres الكاميرا أو Smoke + CO أو Thermostat .

where_id

  • معرّف فريد من نوعه يتم إنشاؤه بواسطة Nest يمثل name
  • where_id للقراءة فقط ، ويتم إنشاؤه تلقائيًا في المكالمة لإنشاء name مخصص

name

  • اسم عرض الجهاز ؛ يمكن أن يكون أي اسم غرفة من قائمة نقدمها ، أو اسم مخصص
  • لإنشاء name مكان مخصص ، قم بإجراء مكالمة POST لكتابة name مكان مخصص جديد ؛ يتم إرجاع where_id في المكالمة
  • اعتبارات
    • name لا يمكن تعديلها أو حذفها بعد إنشاء
    • يجب أن يكون name فريدًا داخل الهيكل
    • إذا تم إقران جهاز إلى الهيكل، والعرف حيث name يرتبط مع الجهاز يمكن الوصول إليها من /structures/ مسار
    • لنقل جهاز له name مخصص لهيكل مختلف ، قم بإلغاء إقران الجهاز ، ثم أعد إقران الجهاز بالاسم المطلوب

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

البيانات الوصفية الأخرى

جميع قيم البيانات للقراءة فقط ، ما لم ينص على خلاف ذلك.

قيمة البيانات وصف
structure_id سلسلة تمثل هذه البنية بشكل فريد. سيرى كل مطور معرّفًا مختلفًا لنفس البنية ، ولكن ستظهر منتجات متعددة من نفس المطوّر نفس المعرّف
country_code رمز البلد ISO 3166-1 alpha-2 الذي يتم تعيينه إلى الموقع المسجل للهيكل
postal_code الرمز البريدي ، حسب الدولة
time_zone سلسلة منطقة زمنية لـ IANA يتم تعيينها للمنطقة الزمنية للهيكل

ميزات الهيكل

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

عند اختيار إذن قراءة Smoke + CO ، يمكنك الوصول إلى smoke_alarm_state co_alarm_state في كائن structures . تتوفر نفس قيم البيانات هذه في كائن الجهاز ( devices/smoke_co_alarms ).

راجع دليل الإنذار Smoke + CO لمزيد من المعلومات حول هذه الحالات.

تعمل العديد من قيم البيانات معًا لتحديد كيفية تصرف الأجهزة في البنية.

  • عندما هيكل away تعيين الدولة away يتم عرض كلمة "ECO" على عش الحرارة، في اللغة المفضلة للمستخدم
  • عندما هيكل away تعيين الدولة away ، يمكنك:
    • تعيين fan_timer_active
    • تغيير target_temperature_f أو target_temperature_c
  • عندما هيكل away تعيين الدولة الى home ، يمكنك:
    • إجراء مكالمة ETA (تعيين معرف الرحلة ونافذة الوصول)
  • عندما يكون fan_timer_active الطوارئ في حالة الطوارئ ، لا يمكنك تعيين fan_timer_active
  • عندما يتم تمكين حرارة الطوارئ ، لا يمكنك ضبط الهيكل away

هياكل متعددة

من الممكن أن يكون لدى المستخدم أكثر من بنية واحدة مرتبطة بحساب Nest الخاص به ، لذا يجب أن يوفر منتجك وسيلة للمستخدم للاختيار من بين الهياكل المتاحة (منتقي الهياكل).

منتقي الهيكل

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

تعرف على كيفية إدارة المستخدمين للأجهزة في هياكل متعددة .

الحد الأقصى للجهاز

هناك حدود لعدد الأجهزة التي يدعمها Nest في البنية.

نوع الجهاز الحد الأقصى لكل هيكل
Nest Thermostat 20
كاميرات Nest 10
Nest Protect 18

رسائل خاطئة

للحصول على معلومات حول معنى أخطاء مكالمات API وكيفية معالجتها ، راجع رسائل الخطأ .