تستخدِم واجهة برمجة التطبيقات Smart Device Management API رموز أخطاء gRPC العادية. لمزيد من المعلومات عن هذه الرموز، يُرجى الاطّلاع على معالجة الأخطاء.
تظهر استجابة الخطأ في واجهة برمجة التطبيقات بالتنسيق التالي:
{
"error": {
"code": 404,
"message": "Device enterprises/project-id/devices/device-id not found.",
"status": "NOT_FOUND"
}
}
استخدِم مربّع البحث في جدول "رموز الأخطاء" للعثور على أخطاء واجهة برمجة التطبيقات، بالإضافة إلى نصائح حول تحديد المشاكل وحلّها والسمات والأدلة ذات الصلة. يمكنك البحث عن محتوى في أي حقل في الجدول.
| رسالة الخطأ | HTTP | متوسط عائد النقرة | تحديد المشاكل وحلّها |
|---|---|---|---|
| لم تعُد صورة الكاميرا متاحة للتنزيل. | 504 | DEADLINE_EXCEEDED |
تنتهي صلاحية صور الحدث بعد 30 ثانية من نشر الحدث. احرص على تنزيل الصورة قبل انتهاء صلاحيتها. راجِع أيضًا: مهمة تنزيل صورة من الكاميرا جهاز العرض جهاز جرس الباب دليل الأحداث أمر GenerateImage CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait |
| لا يمكن تنفيذ الطلب على جرس الباب. | 400 | FAILED_PRECONDITION |
لا يمكن تمديد بث WebRTC على أجراس الباب التي تعمل بالبطارية. إذا كان يجب مشاهدة بث على جرس باب بعد انتهاء مدة الجلسة الأولية، أوقِف البث الحالي وأنشئ بثًا جديدًا. راجِع أيضًا: مهمة إطالة مدة بث مباشر الأمر ExtendWebRtcStream |
| لا يُسمح بهذا الطلب في وضع الترموستات الحالي. | 400 | FAILED_PRECONDITION |
لا تتيح بعض طُرز الترموستات تغيير وضع "توفير الطاقة" عندما يكون وضع الترموستات "غير مفعّل"، وذلك وفقًا لسمة ThermostatMode . يجب تغيير وضع الترموستات إلى HEAT أو COOL أو HEATCOOL قبل تغيير وضع Eco. راجِع أيضًا: مهمة تغيير الوضع الأمر SetMode سمة ThermostatMode سمة ThermostatTemperatureSetpoint |
| لا يُسمح بهذا الأمر عندما يكون الترموستات في وضع MANUAL_ECO. | 400 | FAILED_PRECONDITION |
لا يمكن ضبط درجة الحرارة المثلى عندما يكون الترموستات في وضع "الوضع الاقتصادي" اليدوي. راجِع أيضًا: مهمة تغيير درجات الحرارة المثلى سمة ThermostatEco سمة ThermostatTemperatureSetpoint |
| لم يتم تقديم الأمر. | 404 | NOT_FOUND |
تم تنفيذ أمر بدون اسم أمر صالح في نص الطلب. أدخِل أمرًا صالحًا. |
| الطلب غير متاح. | 400 | INVALID_ARGUMENT |
استخدام أمر بث مباشر عبر بروتوكول RTSP لكاميرا متوافقة مع WebRTC، أو استخدام أمر بث مباشر عبر WebRTC لكاميرا متوافقة مع بروتوكول RTSP راجِع أيضًا: مهمة تنزيل صورة من الكاميرا |
| يحتوي على قيمة غير صالحة. | 400 | INVALID_ARGUMENT |
تم إرسال أمر يتضمّن قيمة غير صالحة في الوسيطات. يُرجى التأكّد من إرسال قيمة صالحة. |
| يجب أن تكون قيمة التبريد أكبر من قيمة الحرارة. | 400 | INVALID_ARGUMENT |
تأكَّد من أنّ الحقل heatCelsius أصغر من الحقل coolCelsius في الأمر.راجِع أيضًا: مهمة تغيير نقاط ضبط درجة الحرارة ThermostatTemperatureSetpoint السمة |
| لم يتم العثور على الجهاز. | 404 | NOT_FOUND |
تم تحديد اسم جهاز غير صالح أو غير متوفّر. حدِّد جهازًا صالحًا. اطّلِع أيضًا على: إمكانية الاتصال |
| لم يتم العثور على المؤسسة. | 404 | NOT_FOUND |
تم تحديد Project معرّف غير صالح أو غير متوفّر. حدِّد Project معرّفًا صالحًا. |
| رقم تعريف الحدث لا يعود للكاميرا. | 400 | FAILED_PRECONDITION |
استخدِم eventID الصحيح الذي يعرضه حدث الكاميرا.راجِع أيضًا: معالجة أحداث الكاميرا عرض الجهاز معالجة أحداث جرس الباب والكاميرا دليل الأحداث CameraEventImage trait CameraMotion trait CameraPerson trait CameraSound trait DoorbellChime trait |
| تعذَّر استرداد بروتوكول وصف الجلسة (SDP) بسبب انتهاء المهلة. | 504 | DEADLINE_EXCEEDED |
حاوِل إنشاء بث مباشر عبر WebRTC مرة أخرى. راجِع أيضًا: |
| الحقل غير متوفّر في السمات. | 400 | INVALID_ARGUMENT |
تم إرسال أمر غير متوافق لإحدى السمات. |
| لا يتضمّن SDP الخاص بالعرض غير الصالح CRLF. | 400 | INVALID_ARGUMENT |
لا يتوفّر حرف سطر جديد في نهاية سلسلة offerSdp عند محاولة إنشاء بث عبر WebRTC. تأكَّد من أنّ سلسلة offerSdp تنتهي بالرمز \r\n أو \n وحاوِل إنشاء ساحة المشاركات مرة أخرى.راجِع أيضًا: |
| أسطر m غير صالحة في SDP للعرض | 400 | INVALID_ARGUMENT |
يجب أن يحتوي ملف SDP الخاص بالعرض على كلّ من خطوط m-audio وm-video وm-application الثلاثة بالترتيب نفسه. راجِع أيضًا: |
| ملف SDP غير صالح للعرض | 400 | INVALID_ARGUMENT |
يجب ضبط ملف SDP الصوتي للعرض على a=recvonly (تلقّي فقط).راجِع أيضًا: |
| تم رفض الإذن. | 403 | PERMISSION_DENIED |
لم يمنِح user developer
الأذونات المناسبة على مستوى الجهاز في "مدير اتصالات الشركاء" (PCM) المطلوبة لتنفيذ أحد أوامر
. عند إنشاء بث مباشر عبر WebRTC، يمكن أن يشير هذا الخطأ أيضًا إلى أنّ إعدادات الصوت في offerSdp غير صحيحة.راجِع أيضًا: مهمة ربط حسابك أمر GenerateWebRtcStream |
| معدّل الاستخدام محدود | 429 | RESOURCE_EXHAUSTED |
يمتلك كل مطوِّر حصة تحدّ من عدد المكالمات التي يمكنه إجراؤها. إذا أجريت مكالمات أكثر من حصتك، ستتلقّى رسالة "تمّ الحد من معدّل المكالمات". لحلّ هذه المشكلة، يُرجى إعادة إرسال المكالمة بعد انتهاء صلاحية الحصة. راجِع أيضًا: مفهوم الحدود القصوى لمعدلات التجارب التجريبية |
| لم يتم العثور على الغرفة. | 404 | NOT_FOUND |
الغرفة غير متوفّرة في البنية. يمكنك إجراء طلب للحصول على قائمة بموارد الغرف للتحقّق من رقم تعريف الغرفة. |
| لم يتم العثور على البنية. | 404 | NOT_FOUND |
البنية غير متوفّرة في Project. يمكنك إجراء طلب قائمة لمصدر البنية للتحقّق من رقم تعريف البنية. |
| الكاميرا غير متاحة للبث. | 400 | FAILED_PRECONDITION |
الكاميرا غير متصلة بالإنترنت أو غير متاحة للبث بسبب مشكلة فنية. راجِع أيضًا: جهاز الكاميرا جهاز الكاميرا (بطارية) جهاز الكاميرا (سلكي) جهاز جرس الباب (بطارية) جهاز جرس الباب (سلكي) أمر GenerateWebRtcStream |
| مروحة الترموستات غير متاحة. | 400 | FAILED_PRECONDITION |
لا يتضمّن الترموستات مروحة. لا يمكن استخدام السمات والأوامر المتعلّقة بالمروحة لهذا الجهاز. راجِع أيضًا: مهمة تشغيل المروحة أو إيقافها سمة المروحة |