Method: courses.courseWork.modifyAssignees

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

يمكن فقط للمعلّم في الدورة التدريبية التي تحتوي على مهام الدورة التدريبية استدعاء هذه الطريقة.

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
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

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