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

تستخدِم واجهة برمجة التطبيقات 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	لا تتيح بعض طُرز الترموستات تغيير الوضع الاقتصادي عندما يكون وضع الترموستات متوقفًا، وذلك وفقًا لسمة ThermostatMode . يجب تغيير وضع الترموستات إلى HEAT أو COOL أو HEATCOOL قبل تغيير الوضع الاقتصادي. راجِع أيضًا:   مهمة تغيير الوضع   أمر 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-lines الثلاثة الخاصة بالصوت والفيديو والتطبيق بهذا الترتيب. راجِع أيضًا:
وصف الجلسة غير صالح.	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	لا يتوافق الترموستات مع المروحة. لا يمكن استخدام السمات والأوامر المتعلقة بالمروحة لهذا الجهاز. اطّلِع أيضًا على:   مهمة تشغيل المروحة أو إيقافها   سمة المروحة