Device Access يتم تقييد المشاريع بسبب حدود المستخدم والبنية والسعر، اعتمادًا على البيئة ونوع العرض التجاري.
نريد من المطورين إنشاء تجارب جذابة للمستخدم، لكننا نريد أيضًا ستتوفّر خدمة Nest وأجهزتها دائمًا للمستخدم. عمليات الدمج التي قد يؤثر إجراء عدد كبير من الطلبات في فترة زمنية معينة على الخدمة مدى توفُّر الجهاز، لذا تطبِّق واجهة برمجة تطبيقات SDM حدود المعدّل. يؤدي تقييد المعدل إلى تقييد عدد طلبات البيانات من واجهة برمجة التطبيقات لفترة زمنية محددة ويمنع الاستخدام الزائد للموارد.
الحدود حسب البيئة
تبدأ جميع المشاريع في بيئة وضع الحماية . تُعد صندوق الحماية المخصص لتقييم واجهة برمجة تطبيقات SDM والاستخدام الشخصي، وحدودها وفقًا لذلك. البيئات ذات قواعد المستخدمين الأكبر، مثل التطوير التجاري ، ولها حدود مختلفة.
حدود المستخدمين في وضع الحماية
ويقتصر حساب المطوِّر في Sandbox على 25 مستخدمًا عبر 5 الهياكل عبر جميع المشروعات. الحد الأقصى 3 مشاريع لكل حساب.
تقتصر التركيبات على 5 مستخدمين لكل منها، لذا سيتم الوصول إلى الحد الأقصى لعدد المستخدمين فقط. بمجرد الوصول إلى الحد الأقصى لجميع الهياكل الخمسة مع 5 مستخدمين لكل منها. حساب المطوّر (مالك المشروع) لا يتم احتسابه ضمن الحد الأقصى لعدد المستخدمين البالغ 5 البنية.
بالعكس، إذا كان المشروع يحتوي على 15 مستخدمًا على 5 هياكل، فيمكن للمستخدمين الإضافيين إلى البنى الخمسة الحالية فقط، حيث إن الحد المسموح به من البنية تم الوصول إليه بالفعل.
حدود المعدل في وضع الحماية
يكون معدل وضع الحماية محدودًا على 3 مستويات مختلفة. تم ضبط الحدود على من طلبات البحث في الدقيقة (QPM) ما لم يُذكر خلاف ذلك.
مستوى واجهة برمجة التطبيقات
تكون طلبات البيانات من واجهة برمجة التطبيقات محدودة لكل مشروع ولكل مستخدم. راجِع واجهة برمجة التطبيقات مرجع لمزيد من المعلومات حول الأشخاص الطرق.
| طريقة واجهة برمجة التطبيقات | قيود على معدل الزيارات |
|---|---|
devices.executeCommand |
10 QPM |
devices.get |
10 QPM |
devices.list |
5 إطارات QPM |
structures.get |
5 إطارات QPM |
structures.list |
5 إطارات QPM |
structures.rooms.get |
5 إطارات QPM |
structures.rooms.list |
5 إطارات QPM |
مستوى الأوامر
يقتصر كل أمر سمة (devices.executeCommand) على 5 QPM لكل مشروع،
لكل مستخدم ولكل جهاز.
وهذا يعني أنّه إذا تضمّن المشروع مستخدمَين يتضمّن كل منهما جهازَين (إجمالي 4 أجهزة)، سيتم تطبيق يمكن استدعاء الأمر نفسه 5 مرات في الدقيقة لكل جهاز من هذه الأجهزة الأربعة.
ومع ذلك، إذا تضمّن المشروع مستخدمَين يمتلك كل منهما 3 أجهزة لإجمالي 6 أجهزة،
ولا يمكن استدعاء الأمر نفسه 5 مرات في الدقيقة لكل من هؤلاء الستة
الأجهزة. وينتج عن ذلك 15 وحدة QPM لكل مستخدم، عند
devices.executeCommand الحد المفروض على مستوى واجهة برمجة التطبيقات لمستخدِم المشروع هو 10 نقاط في الدقيقة.
مستوى النسخة الافتراضية للجهاز
بالإضافة إلى ذلك، يتم تنفيذ الحدود على مستوى مثيل الجهاز على مستوى المشاريع
الطلبات (devices.executeCommand) لحماية بطارية الجهاز. هذه الحدود
تُطبق على مستوى كل من QPM وطلبات البحث في الساعة (QPH) ولا تنطبق
إلى طريقتَي واجهة برمجة التطبيقات get وlist.
على سبيل المثال، لنفترض أن المشروع أ والمشروع ب لديهم حق الوصول إلى نفس الجهاز أو الجهاز "أ" (ربما منح المستخدم ترخيصين مختلفين لأغراض تجارية عمليات الدمج التي تستخدم الجهاز نفسه). إذا أرسل المشروع "أ" 4 أوامر إلى الجهاز "أ" في غضون دقيقة، سيتمكّن المشروع "ب" من إرسال أمر واحد فقط إلى الجهاز "أ" الدقيقة نفسها قبل الوصول إلى الحد الأقصى لمعدل مستوى مثيل الجهاز. في ذلك الوقت يتم تقييد الأوامر من كلا المشروعين إلى الجهاز "أ" حتى نهاية الدقيقة التي بدأت بالأمر الأول إلى الجهاز أ.
إذا لم يكن نوع جهاز مدرجًا أدناه، يعني هذا أنه لا يحتوي على مستوى النسخة الافتراضية للجهاز. لمعدل الزيارات.
| نوع الجهاز | القيود على معدّل نقل البيانات الافتراضية للجهاز |
|---|---|
| جهاز الترموستات | 5 QPM أو 100 QPH |
| الكاميرا | 30 QPM أو 100 QPH |
| DOORBELL | 30 QPM أو 100 QPH |
الأخطاء
قد يتم عرض رموز الخطأ التالية فيما يتعلق بهذا الدليل:
| رسالة الخطأ | متوسط عائد النقرة | تحديد المشاكل وحلّها |
|---|---|---|
| المعدل محدود. | RESOURCE_EXHAUSTED |
يمتلك كل مطوِّر حصة تحدّ من عدد المكالمات التي يمكنه إجراؤها. إذا أجريت مكالمات تتجاوز الحصة المحددة، ستتلقّى رسالة "محدود للمعدّل". لحلّ هذه المشكلة، يُرجى إعادة إرسال المكالمة بعد انتهاء صلاحية الحصة. |
يمكنك الاطّلاع على مرجع رمز خطأ واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز أخطاء واجهة برمجة التطبيقات.