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

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