Method: courses.updateGradingPeriodSettings

لتعديل إعدادات فترة وضع الدرجات لدورة تدريبية

يجب أن يكون المستخدم الذي قدّم الطلب ومالك الدورة التدريبية مؤهَّلَين لتعديل فترات وضع الدرجات. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة متطلبات الترخيص.

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

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بتعديل إعدادات فترة وضع الدرجات في دورة تدريبية أو بسبب أخطاء الوصول:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح.
  • NOT_FOUND إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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

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

المعلمات
courseId

string

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

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

المعلمات
updateMask

string (FieldMask format)

قناع يحدّد الحقول المطلوب تعديلها في GradingPeriodSettings

سيتم استبدال قائمة GradingPeriodSettings gradingPeriods بالكامل بفترات وضع الدرجات المحدّدة في طلب التعديل. على سبيل المثال:

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

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

  • gradingPeriods
  • applyToExistingCoursework

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

previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

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

  • https://www.googleapis.com/auth/classroom.courses

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