Method: courses.courseWork.modifyAssignees

لتعديل وضع المُسنَد إليه وخيارات مهام الدورة الدراسية.

لا يجوز لأحد تسمية هذه الطريقة سوى معلّم الدورة التدريبية الذي يحتوي على الواجب الدراسي.

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

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

طلب HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}:modifyAssignees

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

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

المَعلمات
courseId

string

معرّف الدورة التدريبية. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو alias.
id

string

معرّف الدورة الدراسية.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
الحقول
assigneeMode

enum (AssigneeMode)

نموذج لمهام الدورة الدراسية يصف ما إذا كان سيتم إسنادها لجميع الطلاب أو لطلاب معيّنين محدّدين.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

يمكنك تحديد الطلاب الذين تم تكليفهم بواجب الدورة الدراسية أو الذين لم يتم تكليفهم به. يجب تحديد قيمة السمة assigneeMode فقط عندما تكون القيمة INDIVIDUAL_STUDENTS.

نص الاستجابة

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

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

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

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

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