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

تستخدم واجهة برمجة التطبيقات لإدارة الأجهزة الذكية رموز خطأ 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 لا يمكن تغيير وضع "درجات حرارة اقتصادية" في بعض طُرز الترموستات. يجب تغيير وضع الترموستات إلى "التدفئة" أو "التبريد" أو "التدفئة" قبل تغيير وضع "درجات حرارة اقتصادية".

راجع أيضًا:
مهمة تغيير الوضع
الأمر SetMode
ThermostatMode trait
ThermostatTemperatureSetpoint trait
لا يُسمح بالطلب عند تفعيل الترموستات في وضع 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 تم إرسال أمر غير متوافق لإحدى السمات.
لا تتوفّر قائمة الشهادات الباطلة (CRLF) في ما يخص العرض غير الصالح. 400 INVALID_ARGUMENT لا يتوفّر حرف السطر الجديد في نهاية سلسلة offerSdp عند محاولة إنشاء بث WebRTC. تأكَّد من أنّ سلسلة offerSdp تنتهي بالرمز \r\n أو \n وحاوِل إنشاء ساحة المشاركات مرة أخرى.

راجِع أيضًا:
قيم m-line للعرض غير صالحة. 400 INVALID_ARGUMENT يجب أن يحتوي بروتوكول وصف الجلسة (SDP) الخاص بالعرض على خطوط الصوت والفيديو والتطبيقات الثلاثة جميعها بهذا الترتيب.

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

راجِع أيضًا:
مهمة تشغيل المروحة أو إيقافها
Fan trait