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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.