حدود المستخدم والمعدل

Device Access تخضع المشاريع لقيود المستخدم والبنية والأسعار، بناءً على البيئة ونوع العرض التجاري.

نريد من المطوّرين تقديم تجارب جذّابة للمستخدمين، إلا أنّنا نريد أيضًا إتاحة خدمة Nest وأجهزتها للمستخدمين بشكل دائم. يمكن أن تؤثر عمليات الدمج التي تُجري عددًا كبيرًا من الطلبات خلال فترة زمنية معيّنة على مدى توفّر الخدمة والأجهزة، لذا تطبّق واجهة برمجة تطبيقات SDM الحدود القصوى للمعدّل. إنّ الحدّ من المعدّل يحدّ من عدد طلبات البيانات من واجهة برمجة التطبيقات لفترة زمنية معيّنة، كما يمنع الإفراط في استخدام الموارد.

الحدود القصوى حسب البيئة

وتبدأ جميع المشاريع في بيئة   وضع الحماية  . تم تصميم Sandbox لتقييم واجهة برمجة تطبيقات SDM والاستخدام الشخصي، ويتم تقييد الحدود وفقًا لذلك. البيئات ذات قواعد المستخدمين الأكبر، مثل   التطوير التجاري  ، لها حدود مختلفة.

حدود مستخدمي وضع الحماية

إنّ حساب المطوّر في "وضع الحماية" يقتصر على 25 مستخدمًا في 5 بُنى في جميع المشاريع. هناك حدّ أقصى يبلغ 3 مشاريع لكل حساب.

تقتصر البنى على 5 مستخدمين لكل منهما، لذا لن يتم الوصول إلى الحد الأقصى للمستخدمين إلا بعد الوصول إلى جميع البُنى الخمسة إلى أقصى حد بحيث يتضمّن كل منها 5 مستخدمين. لا يتم احتساب حساب المطوّر (الذي يملك المشروع) ضمن الحدّ الأقصى البالغ 5 مستخدمين للهيكل.

وعلى العكس من ذلك، إذا كان المشروع يحتوي على 15 مستخدمًا عبر 5 هياكل، فيمكن إضافة مستخدمين إضافيين فقط إلى الهياكل الخمسة الحالية، حيث تم الوصول إلى الحد الأقصى للبنية بالفعل.

حدود معدل وضع الحماية

يقتصر معدل وضع الحماية على 3 مستويات مختلفة. يتم ضبط الحدود على طلبات البحث في الدقيقة (QPM) ما لم يُذكر خلاف ذلك.

مستوى واجهة برمجة التطبيقات

تكون طلبات البيانات من واجهة برمجة التطبيقات محدودة لكل مشروع ولكل مستخدم. راجِع مرجع واجهة برمجة التطبيقات للاطّلاع على مزيد من المعلومات حول الطرق الفردية.

طريقة واجهة برمجة التطبيقات	سقف المعدّل
devices.executeCommand	10 QPM
devices.get	10 QPM
devices.list	5 فترات في اليوم
structures.get	5 فترات في اليوم
structures.list	5 فترات في اليوم
structures.rooms.get	5 فترات في اليوم
structures.rooms.list	5 فترات في اليوم

مستوى الأوامر

يقتصر كل أمر سمة (devices.executeCommand) على 5 دقائق في الدقيقة لكل مشروع، لكل مستخدم، لكل جهاز.

وهذا يعني أنه إذا كان المشروع يحتوي على مستخدمَين لكل منهما جهازين (إجمالي 4 أجهزة)، يمكن استدعاء الأمر نفسه 5 مرات في الدقيقة لكل جهاز من هذه الأجهزة الأربعة.

ومع ذلك، إذا كان المشروع يحتوي على مستخدمَين يمتلك كل جهاز منهما 3 أجهزة لكل 6 أجهزة إجمالاً، يتعذّر استدعاء الأمر نفسه 5 مرات في الدقيقة لكل جهاز من هذه الأجهزة الستة. وسيؤدّي ذلك إلى تحقيق 15 QPM لكل مستخدم، إذا كان الحدّ الأقصى لمعدّل مستوى واجهة برمجة التطبيقات devices.executeCommand لمستخدِم المشروع هو 10 QPM.

مستوى مثيل الجهاز

بالإضافة إلى ذلك، يتم تطبيق الحدود القصوى على مستوى مثيلات الجهاز في المشاريع والطلبات (devices.executeCommand) لحماية بطارية الجهاز. يتم تطبيق هذه الحدود في كل من مستويات QPM وطلبات البحث في الساعة (QPH)، ولا تنطبق على طريقتي واجهة برمجة التطبيقات get وlist.

على سبيل المثال، لنفترض أن المشروع "أ" والمشروع "ب" يتمتعان بإمكانية الوصول إلى الجهاز نفسه، الجهاز "أ" (ربما يكون المستخدم قد فوّض عمليتَي دمج تجاريتين مختلفتين تستخدمان الجهاز نفسه). إذا أرسل المشروع "أ" 4 أوامر إلى الجهاز "أ" في غضون دقيقة، سيتمكن المشروع "ب" من إرسال أمر واحد فقط إلى الجهاز "أ" في الدقيقة نفسها قبل الوصول إلى الحدّ الأقصى لمعدّل مستوى مثيل الجهاز. في هذه المرحلة، يتم تقييد الأوامر من كلا المشروعين إلى الجهاز أ حتى نهاية الدقيقة التي بدأت بالأمر الأول إلى الجهاز أ.

إذا لم يكن نوع الجهاز مدرجًا أدناه، لن يكون له حدود لسعر الجهاز الافتراضي.

نوع الجهاز	الحدّ الأقصى لمعدّل الأجهزة الافتراضية
ترموستات	5 QPM أو 100 QPH
الكاميرا	30 QPM أو 100 QPH
جرس الباب	30 QPM أو 100 QPH

الأخطاء

قد يتم عرض رموز الخطأ التالية في ما يتعلق بهذا الدليل:

رسالة الخطأ	متوسط عائد النقرة	تحديد المشاكل وحلّها
المعدل محدود.	RESOURCE_EXHAUSTED	لكل مطوّر برامج حصة تقيّد عدد المكالمات التي يمكنه إجراؤها. إذا أجريت مكالمات أكثر من الحصة المخصّصة لك، ستتلقّى رسالة "الحدّ الأقصى للسعر". لحلّ هذه المشكلة، يُرجى إعادة إرسال المكالمة بعد انتهاء صلاحية الحصة.

ويمكنك الاطّلاع على مرجع رموز الأخطاء في واجهة برمجة التطبيقات للاطّلاع على القائمة الكاملة لرموز الأخطاء في واجهة برمجة التطبيقات.