Method: courses.updateGradingPeriodSettings

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض

إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح استخدام ميزات معيّنة قبل إطلاقها. تتوفّر هذه الميزة في الإصدار V1_20240401_PREVIEW والإصدارات الأحدث. اطّلِع على الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة للاطّلاع على مزيد من المعلومات.

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

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

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

• 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

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