Google is committed to advancing racial equity for Black communities. See how.

بنية

الهياكل

تمثل هياكل العش الهياكل المادية في العالم الحقيقي. عادةً ما يكون منزل المستخدم بمثابة نقطة تنظيم للأجهزة وسيقوم بتخزين البيانات التي تنطبق على المنزل بأكمله.

و API عش يوفر الوصول إلى البيانات على مستوى البنية التالية، التي تعتمد على مستوى الأذونات الممنوحة:

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

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

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

للوصول إلى ... يختار...
معظم قيم البيانات في structures وجوه بعيدا ، ETA ، الطاقة ، أو الرمز البريدى أذونات
على name قيمة البيانات في structures وجوه هيكل القراءة / الكتابة إذن

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

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

اسم

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

اين

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

الوصول إلى wheres الكائن يتطلب كاميرا ، دخان + CO إنذار ، أو ترموستات الأذونات.

where_id

  • فريد، معرف ولدت عش التي تمثل name
  • where_id للقراءة فقط، ويتم إنشاؤه تلقائيا في الدعوة إلى خلق العرف حيث name

name

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

تعلم المزيد عن أسماء الحرارة عش ،عش يحمي و عش الحدب .

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

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

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

ميزات الهيكل

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

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

رؤية دخان + دليل إنذار ثاني أكسيد الكربون لمزيد من المعلومات حول هذه الدول.

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

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

هياكل متعددة

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

منتقي الهيكل

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

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

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

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

نوع الجهاز ماكس لكل هيكل
Nest ثرموستات 20
كاميرات Nest 10
Nest Protect 18

رسائل خاطئة

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