مرجع رمز خطأ واجهة برمجة التطبيقات

تستخدِم واجهة برمجة التطبيقات لمجموعة أدوات Smart Device Management رموز خطأ gRPC العادية. لمزيد من المعلومات حول هذه الرموز، يُرجى الاطّلاع على التعامل مع الأخطاء.

يظهر ردّ الخطأ في واجهة برمجة التطبيقات بالتنسيق التالي:

{   "error": {     "code": 404,     "message": "Device enterprises/project-id/devices/device-id not found.",     "status": "NOT_FOUND"   } }

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

رسالة الخطأ HTTP متوسط عائد النقرة تحديد المشاكل وحلّها
لم تعُد صورة الكاميرا متاحة للتنزيل. 504 DEADLINE_EXCEEDED تنتهي صلاحية صور الأحداث بعد 30 ثانية من نشر الحدث. احرص على تنزيل الصورة قبل انتهاء صلاحيتها.

راجِع أيضًا:
  مهمة تنزيل صورة من الكاميرا
  جهاز العرض
  جهاز جرس الباب
  دليل الأحداث
  الأمر GenerateImage
  السمةCameraMotion
  السمةCameraPerson
  السمةCameraSound
  السمةDoorbellChime
الطلب غير متاح لجرس الباب. 400 FAILED_PRECONDITION لا يمكن تمديد مدة بث WebRTC على أجراس الأبواب التي تعمل بالبطارية. إذا كان يجب مشاهدة بث على جرس الباب لفترة أطول من مدة الجلسة الأولية، أوقِف البث الحالي وأنشئ بثًا جديدًا.

اطّلِع أيضًا على:
  مهمة تمديد بث مباشر
  أمر ExtendWebRtcStream
لا يُسمح بتنفيذ الأمر في وضع الترموستات الحالي. 400 FAILED_PRECONDITION لا تتيح بعض طُرز الترموستات تغيير الوضع الاقتصادي عندما يكون وضع الترموستات OFF، وذلك وفقًا لسمة ThermostatMode . يجب تغيير وضع الترموستات إلى HEAT أو COOL أو HEATCOOL قبل تغيير الوضع الاقتصادي.

راجِع أيضًا:
  مهمة تغيير الوضع
  أمر SetMode
  سمة ThermostatMode
  سمة ThermostatTemperatureSetpoint
لا يُسمح بتنفيذ الأمر عندما يكون الترموستات في وضع MANUAL_ECO. 400 FAILED_PRECONDITION لا يمكن ضبط درجة الحرارة المثلى عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي.

راجِع أيضًا:
  المهمة تغيير درجات الحرارة المثلى
  ThermostatEco trait
  ThermostatTemperatureSetpoint trait
لم يتم تقديم الأمر. 404 NOT_FOUND تم تنفيذ أمر بدون اسم أمر صالح في نص الطلب. يُرجى إدخال أمر صالح.
الطلب غير متاح. 400 INVALID_ARGUMENT استخدام أمر بث مباشر عبر بروتوكول RTSP لكاميرا متوافقة مع WebRTC، أو استخدام أمر بث مباشر عبر WebRTC لكاميرا متوافقة مع بروتوكول RTSP

راجِع أيضًا:
  مهمة تنزيل صورة من الكاميرا
يحتوي على قيمة غير صالحة. 400 INVALID_ARGUMENT تم إرسال أمر بقيمة غير صالحة في الوسيطات. يُرجى التأكّد من إرسال قيمة صالحة.
يجب أن تكون قيمة التبريد أكبر من قيمة التسخين. 400 INVALID_ARGUMENT تأكَّد من أنّ قيمة الحقل heatCelsius أقل من قيمة الحقل coolCelsius في الأمر الذي ترسله.

اطّلِع أيضًا على:
  مهمة تغيير درجات الحرارة المثلى
  ThermostatTemperatureSetpoint trait
لم يتم العثور على الجهاز. 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 الثلاثة الخاصة بالصوت والفيديو والتطبيق بهذا الترتيب.

راجِع أيضًا:
وصف الجلسة غير صالح. 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 لا يتوافق الترموستات مع المروحة. لا يمكن استخدام السمات والأوامر المتعلقة بالمروحة لهذا الجهاز.

اطّلِع أيضًا على:
  مهمة تشغيل المروحة أو إيقافها
  سمة المروحة