Method: courses.courseWork.modifyAssignees

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

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

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

  • ‫PERMISSION_DENIED إذا لم يكن لدى المستخدم الذي يقدّم الطلب إذن بالوصول إلى الدورة التدريبية أو العمل المطلوب أو في حال حدوث أخطاء في الوصول
  • INVALID_ARGUMENT إذا كان الطلب غير صالح
  • ‫NOT_FOUND إذا لم تكن الدورة التدريبية أو المهمة الدراسية المطلوبة متاحة
  • FAILED_PRECONDITION للتعرّف على خطأ الطلب التالي:
    • EmptyAssignees

طلب 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

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