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