يمكنك الانتقال إلى google.classroom.v1.Rubric للاطّلاع على تفاصيل الحقول التي يمكن تعديلها. تصبح إمكانيات تعديل قواعد التقييم محدودة بعد بدء وضع الدرجات.
يجب إجراء هذا الطلب من خلال وحدة تحكُّم Google Cloud الخاصة بمعرِّف عميل OAuth المُستخدَم لإنشاء عنصر عمل الدورة الدراسية الرئيسية.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED إذا لم ينشئ مشروع المطوِّر الذي يقدّم الطلب الدورة التدريبية المقابلة، أو إذا لم يكن مسموحًا للمستخدم بإجراء التعديل المطلوب على قواعد التقييم، أو بسبب أخطاء الوصول. يتم أيضًا عرض رمز الخطأ هذا إذا سبق أن بدأت عملية وضع الدرجات في قاعدة التقييم.
INVALID_ARGUMENT إذا كان الطلب مكتوبًا بصيغة غير صحيحة وبالنسبة إلى خطأ الطلب التالي:
RubricCriteriaInvalidFormat
NOT_FOUND إذا لم تتوفر الدورة التدريبية أو عمل الدورة الدراسية أو قواعد التقييم المطلوبة أو إذا لم يكن لدى المستخدم الإذن بالوصول إلى عمل الدورة الدراسية المقابل.
INTERNAL إذا سبق أن بدأت عملية وضع الدرجات في قاعدة التقييم
اختياري. قناع يحدِّد الحقول التي يجب تعديلها في قاعدة التقييم. هذا الحقل مطلوب لإجراء تعديل. يتعذّر التعديل في حال تحديد حقول غير صالحة. تتوفّر عدة خيارات لتحديد معايير قواعد التقييم: قائمتا sourceSpreadsheetId وcriteria. يمكن استخدام أحد هذه القواعد فقط في كل مرة لتعريف قواعد التقييم.
تم استبدال قائمة criteria الخاصة بقواعد التقييم بالكامل بمعايير قواعد التقييم المحدَّدة في طلب التعديل. على سبيل المثال، إذا كان أحد المعايير أو المستوى غير متوفّر في الطلب، سيتم حذفه. تتم إضافة معايير ومستويات جديدة، كما يتم تخصيص رقم تعريف. تحتفظ المعايير والمستويات الحالية بالمعرّف الذي تم تعيينه في السابق إذا تم تحديد رقم التعريف في الطلب.
يمكن للمعلّمين تحديد الحقول التالية:
criteria
sourceSpreadsheetId
هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
اختياري. إصدار المعاينة من واجهة برمجة التطبيقات يجب ضبط هذا الإعداد للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".