تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إذا لم تكن على دراية بميزة "بطاقات التقييم" في Classroom، يمكنك الاطّلاع على مقالات "مركز المساعدة" هذه للتعرّف على البنية العامة لبطاقة التقييم وكيفية التقييم باستخدام بطاقة التقييم في واجهة مستخدم Classroom.
بنية قواعد التقييم
في ما يلي بعض المفاهيم المهمة التي قد يكون من المفيد تسليط الضوء عليها عند استخدام واجهة برمجة التطبيقات للتفاعل مع نماذج التقييم:
هناك نموذج تقييم واحد (على الأكثر) مرتبط CourseWork،
ويكون نموذج التقييم هذا فريدًا بالنسبة إلى CourseWork (لا يمكن مشاركته بين
موارد CourseWork).
تتألف قاعدة التقييم من معايير تتألف بدورها من مستويات. يجب أن تحتوي قاعدة التقييم دائمًا على معيار واحد على الأقل، ويجب أن يحتوي المعيار دائمًا على مستوى واحد على الأقل.
يمكن أن تكون المستويات مصحوبة بدرجات (نقاط) أو غير مصحوبة بدرجات (بلا نقاط). يجب أن تكون المستويات
إما مسجّلة الدرجات بالكامل أو غير مسجّلة الدرجات بالكامل في نموذج التقييم.
إذا تم احتساب الدرجات في المستويات، يجب أن تتضمّن جميع المستويات في أحد المعايير مجموعة فريدة من قيم النقاط. يمكن أن تكون النقاط أعدادًا صحيحة (مثل 10) أو قيمًا ذات فاصلة عشرية (مثل 9.99). يمكن أن يشمل ذلك الرقم 0. لا يتم قبول القيم الخالية.
بالإضافة إلى ذلك، لا يمكن أن يتضمّن نموذج التقييم معيارًا واحدًا بمستوى واحد
يساوي 0 نقطة.
إذا كانت المستويات غير مسجّلة، يجب حذف حقل النقاط، ولا يتم قبول القيم الفارغة.
إنّ ترتيب المعايير والمستويات مهم ويعكس الترتيب الذي تظهر به في واجهة مستخدم Classroom.
يجب دائمًا ترتيب المستويات التي تتضمّن نتائج حسب النقاط بالترتيب التصاعدي أو التنازلي.
يمكن أن تتضمّن كل بطاقة تقييم ما يصل إلى 50 معيارًا وما يصل إلى 10 مستويات أداء لكل معيار.
بالإضافة إلى السمتَين draftGrade وassignedGrade الحالية، يتضمّن واجب الطالب الذي تم تقييمه باستخدام نموذج تقييم السمتَين draftRubricGrades وassignedRubricGrades. تمثّل هذه السمة درجات التقييم (المستويات المحدّدة وقيم النقاط) التي يحصل عليها الطالب أثناء التقييم من نموذج التقييم، وذلك في حالتَي المسودة والتعيين على التوالي.
في الوقت الحالي، يمكن قراءة هذه المواقع الإلكترونية فقط. هذا يعني أنّه لا يمكن استخدام واجهة برمجة التطبيقات لوضع درجات على المهام التي تم تسليمها، ولكن يمكنك الاطّلاع على المهام التي تم وضع درجات عليها في واجهة مستخدم Classroom.
سلوكيات قواعد التقييم
تهدف واجهة برمجة التطبيقات إلى محاكاة واجهة مستخدم Classroom قدر الإمكان لتحقيق التناسق، ولكن قد يؤدي ذلك إلى سلوك غير بديهي للمطوّرين، لذا من المهم الإشارة إلى ما يلي:
تهدف نماذج التقييم إلى توجيه عملية وضع الدرجات بدون تقييد المعلّمين. نتيجةً لذلك، يمكن للمعلّم إجراء ما يلي عند تقييم مهمة باستخدام نموذج تقييم:
تجاهل قواعد التقييم تمامًا عند وضع الدرجات
تجاوز النقاط المخصّصة لأحد المعايير، بغض النظر عن النقاط المتاحة في مستويات المعيار
اختَر مستويات لمجموعة فرعية فقط من المعايير.
تعيين نقاط لمعيار بدون اختيار مستوى مطابق
تجاوز إجمالي نقاط المهمة، بغض النظر عن النقاط التي سيتم الحصول عليها من نموذج التقييم
بالإضافة إلى ذلك، لا تتيح واجهة برمجة التطبيقات سلوكًا لا تتضمّنه واجهة مستخدم Classroom. على سبيل المثال، لا تتيح واجهة برمجة التطبيقات فرض استخدام نماذج التقييم في المهام أو إلغاء قدرة المعلّم على تعديل نماذج التقييم والمستندات المرسَلة كما يمكنه فعل ذلك اليوم.
القيود أثناء وضع الدرجات
وبالمثل، هناك بعض القيود الإضافية المفروضة على تعديل قواعد التقييم بعد أن يبدأ المعلّم في وضع العلامات باستخدامها. لا يمكن إجراء سوى التعديلات التالية بعد بدء التقييم:
يُسمح بتعديل النصوص الخاصة بمعايير التقييم ومستوياته وعناوينها وأوصافها.
يمكن أن يتغيّر ترتيب المستويات ضمن المعايير.
النطاقات الإضافية
يمكن تصدير نماذج التقييم يدويًا إلى "جداول بيانات Google" ليتمكن المعلّمون من إعادة استخدامها.
إذا أنشأت أو عدّلت نموذج تقييم من جداول البيانات هذه (اطّلِع على مثال في الدليل)، يجب أن يطلب تطبيقك النطاق https://www.googleapis.com/auth/spreadsheets.readonly أو https://www.googleapis.com/auth/spreadsheets. يُرجى العِلم أنّ نطاقات
spreadsheets تُعد حساسة وقد تتطلّب إثبات ملكية تطبيقك.
الدروس الدراسية التابعة لجهات خارجية
لا يمكن إنشاء نماذج التقييم إلا من خلال مشروع Google Cloud الذي أنشأ العنصر الأب CourseWork. هذا نمط تصميم أوسع في Classroom API يمنع التطبيقات المختلفة من التأثير في الموارد التي لا تخصّها.
وينطبق ذلك أيضًا على المراجع التي ينشئها المستخدمون في تطبيق Classroom.
على سبيل المثال، لا يمكن لأي تطبيق إدارة نماذج التقييم الخاصة بالواجبات التي أنشأها المعلّم في واجهة مستخدم Classroom، حتى إذا كان المعلّم نفسه هو مالك التطبيق. إذا كان ذلك يحدّ بشكل كبير من حالة الاستخدام، يُرجى مشاركة ملاحظاتك في أداة تعقُّب المشاكل العامة.
متطلبات الترخيص
لا يمكن للمستخدم إنشاء نماذج تقييم وتعديلها وحذفها باستخدام Classroom API إلا إذا استوفى الشروط التالية:
اطّلِع على أهلية المستخدم لمعرفة المزيد حول كيفية إتاحة إمكانات واجهة برمجة التطبيقات للمستخدمين، والمتطلبات الأساسية لواجهة برمجة التطبيقات Classroom API للتعرّف على حساب تجريبي وطلب الحصول عليه لأغراض التطوير.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Rubrics structure and known limitations\n\nIf unfamiliar with Classroom Rubrics, see these Help Center articles to learn\nabout the [general structure](https://support.google.com/edu/classroom/answer/9335069?co=GENIEPlatform%3DDesktop#zippy=%2Cdelete-an-assignments-rubric%2Cedit-an-assignments-rubric%2Cshare-rubrics-with-export-and-import%2Csee-an-assignments-rubric%2Cadd-a-rubric-to-an-existing-assignment%2Creuse-a-rubric%2Ccreate-a-rubric%2Crubric-overview) of a rubric and how [rubric grading](https://support.google.com/edu/classroom/answer/9335428?ref_topic=11599451&sjid=7396534141168895349-NA) is done in\nthe Classroom UI.\n\nRubrics structure\n-----------------\n\nThere are some important concepts that may be worth highlighting when using the\nAPI to interact with rubrics:\n\n- There is (at most) a single [rubric](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics) associated with a [`CourseWork`](/workspace/classroom/reference/rest/v1/courses.courseWork) and that rubric is unique to that `CourseWork` (it is not shareable across `CourseWork` resources).\n- The rubric consists of [criteria](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#criterion), which consist of [levels](/workspace/classroom/reference/rest/v1/courses.courseWork.rubrics#level). A rubric must always have at least one criteria, and a criterion must always have at least one level.\n- Levels can be scored (have points) or unscored (no points). Levels must be entirely scored or entirely unscored in a rubric.\n - If the levels are scored, all levels in a criterion must have a unique points value set. Points can be integers (like 10) or floating point values (like 9.99). This can include 0. Null values are not accepted. Additionally, a rubric can't have a single criteria with a single level that is 0 points.\n - If the levels are unscored, the points field should be omitted; null values are not accepted.\n- The order for criteria and levels is meaningful and reflects the order they are represented in the Classroom UI.\n - Scored levels in particular must always be sorted by points in either increasing or decreasing order.\n- There can be up to 50 criteria per rubric and up to 10 performance levels per criterion.\n\nRelated student submission fields\n---------------------------------\n\n[`StudentSubmission`](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions) objects support rubrics-related fields:\n\n- In addition to the existing `draftGrade` and `assignedGrade` properties, a student submission graded with a rubric has `draftRubricGrades` and `assignedRubricGrades` properties. These represent the rubric grades (levels selected and point values) the student receives during grading from the rubric, in the draft and assigned states, respectively.\n- For now, these properties are read-only. This means that *the API can't be\n used to grade submissions*, but you can read submissions graded in the Classroom UI.\n\nRubrics behaviors\n-----------------\n\nThe API aims to mirror the Classroom UI whenever possible for consistency, but\nthis can lead to behaviour that may be unintuitive for developers and is worth\nmentioning:\n\n- Rubrics are intended to *guide* grading without constraining teachers. As a result, a teacher can do the following when grading a submission with a rubric:\n - Completely ignore the rubric when grading.\n - Override the points for a criterion, irrespective of the points available in the criterion's levels.\n - Select levels for only a subset of criteria.\n - Assign points for a criteria without selecting a corresponding level.\n - Override the assignment's total points, irrespective of the points that would come from the rubric.\n\nAdditionally, the API doesn't support behavior the Classroom UI doesn't already\nhave. For example, the API doesn't enable enforcing rubrics usage on assignments\nor overriding a teacher's ability to edit rubrics and submissions as they can\ntoday.\n\nLimitations during grading\n--------------------------\n\nSimilarly, there are some additional limitations place on editing rubrics once a\nteacher has started grading with it. Only the following edits are possible after\ngrading as started:\n\n- Text edits are allowed for criterion and level titles and descriptions.\n- Level ordering can change within criteria.\n\nAdditional scopes\n-----------------\n\nRubrics can be manually [exported](https://support.google.com/edu/classroom/answer/9335069?co=GENIE.Platform%3DDesktop#zippy=%2Cshare-rubrics-with-export-and-import) to Google Spreadsheets for re-use by\nteachers.\n\nIf you create or update a rubric from these spreadsheets (see an [example in the\nguide](/workspace/classroom/rubrics/getting-started#export-and-import-rubrics)), your application needs to request the\n`https://www.googleapis.com/auth/spreadsheets.readonly` or\n`https://www.googleapis.com/auth/spreadsheets` scope. Be aware that the\n`spreadsheets` scopes are considered sensitive and may require your application\nto be [verified](https://support.google.com/cloud/answer/9110914).\n\nThird-party coursework\n----------------------\n\nRubrics can only be created by the Google Cloud project that created the parent\n`CourseWork` item. This is a broader design pattern in the\nClassroom API which prevents different applications from impacting\nresources that aren't thiers.\n\nThis extends to resources created by users in the Classroom app.\nFor example, It's not possible for an application to manage rubrics for a\ncoursework that a teacher created in the Classroom UI, even if\nthe same teacher owns the application. If this significantly limits your use\ncase, share feedback in the [public issue tracker](https://issuetracker.google.com/issues/new?component=191645&template=823907).\n\nLicense requirements\n--------------------\n\nA user can only create, update, and delete rubrics with the\nClassroom API if the following conditions are met:\n\n- The user making the request has a [Google Workspace for Education Plus](https://edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/) license assigned to them.\n- The course owner of the corresponding course has a [Google Workspace for Education Plus](https://edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/) license assigned to them.\n\nSee [user eligibility](/workspace/classroom/guides/key-concepts/user-eligibility) to learn more about how API\ncapabilities are exposed to users and Classroom API [prerequisites](https://developers.google.com/workspace/classroom/guides/onboarding/prerequisites) to\nbecome familiar with, and request, a demo account for development."]]