Method: courses.courseWork.rubrics.patch

تعديل قواعد التقييم

يمكنك الانتقال إلى google.classroom.v1.Rubric للاطّلاع على تفاصيل الحقول التي يمكن تعديلها. تصبح إمكانيات تعديل قواعد التقييم محدودة بعد بدء وضع الدرجات.

يجب إجراء هذا الطلب من خلال وحدة تحكُّم Google Cloud الخاصة بمعرِّف عميل OAuth المُستخدَم لإنشاء عنصر عمل الدورة الدراسية الرئيسية.

تعرض هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم ينشئ مشروع المطوِّر الذي يقدّم الطلب الدورة التدريبية المقابلة، أو إذا لم يكن مسموحًا للمستخدم بإجراء التعديل المطلوب على قواعد التقييم، أو بسبب أخطاء الوصول. يتم أيضًا عرض رمز الخطأ هذا إذا سبق أن بدأت عملية وضع الدرجات في قاعدة التقييم.
  • INVALID_ARGUMENT إذا كان الطلب مكتوبًا بصيغة غير صحيحة وبالنسبة إلى خطأ الطلب التالي:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND إذا لم تتوفر الدورة التدريبية أو عمل الدورة الدراسية أو قواعد التقييم المطلوبة أو إذا لم يكن لدى المستخدم الإذن بالوصول إلى عمل الدورة الدراسية المقابل.
  • INTERNAL إذا سبق أن بدأت عملية وضع الدرجات في قاعدة التقييم

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
courseId

string

مطلوبة. معرّف الدورة التدريبية.
courseWorkId

string

مطلوبة. تمثّل هذه السمة معرّف عمل الدورة الدراسية.
id

string

اختياري. هو معرّف قاعدة التقييم.

معلمات طلب البحث

المَعلمات
updateMask

string (FieldMask format)

اختياري. قناع يحدِّد الحقول التي يجب تعديلها في قاعدة التقييم. هذا الحقل مطلوب لإجراء تعديل. يتعذّر التعديل في حال تحديد حقول غير صالحة. تتوفّر عدة خيارات لتحديد معايير قواعد التقييم: قائمتا sourceSpreadsheetId وcriteria. يمكن استخدام أحد هذه القواعد فقط في كل مرة لتعريف قواعد التقييم.

تم استبدال قائمة criteria الخاصة بقواعد التقييم بالكامل بمعايير قواعد التقييم المحدَّدة في طلب التعديل. على سبيل المثال، إذا كان أحد المعايير أو المستوى غير متوفّر في الطلب، سيتم حذفه. تتم إضافة معايير ومستويات جديدة، كما يتم تخصيص رقم تعريف. تحتفظ المعايير والمستويات الحالية بالمعرّف الذي تم تعيينه في السابق إذا تم تحديد رقم التعريف في الطلب.

يمكن للمعلّمين تحديد الحقول التالية:

  • criteria
  • sourceSpreadsheetId

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

اختياري. إصدار المعاينة من واجهة برمجة التطبيقات يجب ضبط هذا الإعداد للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".

نص الطلب

يحتوي نص الطلب على مثال Rubric.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Rubric.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.coursework.students

لمزيد من المعلومات، راجِع دليل التفويض.