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

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