تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض Classroom API معلومات عن الأخطاء التي يمكن أن تساعد المطوّرين في تحديد المشاكل وحلّها وتقديم معلومات مفيدة وقابلة للتنفيذ للمستخدمين النهائيين. يوضّح هذا
الدليل كيفية تحليل معلومات الخطأ التي يتم عرضها من واجهة برمجة التطبيقات.
تعرض Classroom API مستويَين من معلومات الخطأ:
رمز خطأ HTTP في العنوان
عنصر في نص الاستجابة يتضمّن تفاصيل إضافية
بنية رسالة الخطأ
تشمل الأخطاء التي يتم عرضها في نص الاستجابة الحقول التالية:
code: رمز الخطأ الرقمي في HTTP مثلاً: 403
message: تفاصيل إضافية عن الخطأ عندما يكون ذلك متاحًا، يتمّ وضع @ ونوع خطأ معيّن في بداية رسالة الخطأ. على سبيل المثال،
@ClassroomApiDisabled.
status: حالة طلب HTTP على سبيل المثال، PERMISSION_DENIED أو
NOT_FOUND.
{"error":{"code":403,"message":"@ClassroomApiDisabled The user is not permitted to access the Classroom API.","status":"PERMISSION_DENIED"}}
يمكنك استخدام نص الردّ لمساعدتك في تصحيح أخطاء سبب الخطأ و
تقديم معلومات مفيدة للمستخدمين. أدرِج مسافة في نهاية السلسلة عند البحث عن رسالة خطأ معيّنة لتجنّب مطابقة القيم الأخرى التي تبدأ بالسلسلة نفسها. في مثال الخطأ المقدَّم، يمكنك التحقّق مما إذا كان حقل الرسالة
يبدأ بالرمز "@ClassroomApiDisabled " لتقديم معلومات مناسبة
للمستخدمين.
يمكنك الرجوع إلى صفحة الأخطاء الشائعة للحصول على معلومات عن بعض الأخطاء التي
يمكن أن تعرِضها Classroom API.
تاريخ التعديل الأخير: 2025-01-30 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-01-30 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Classroom API provides error information via HTTP error codes in the header and detailed error objects in the response body."],["Error objects in the response body contain a numerical `code`, a detailed `message` potentially including a specific error type prepended with `@`, and an HTTP request `status`."],["Developers can use the error `message` field, particularly by checking for specific prefixes like `@ClassroomApiDisabled `, to debug issues and inform users."],["The error message structure provided by the API allows for the extraction of the HTTP code, the reason behind the error and its status."],["Refer to the Common Errors page to see a detailed list of possible error messages and the actions that can be taken in response to them."]]],[]]
