لتعديل وضع المُسنَد إليه وخيارات مهام الدورة الدراسية.
لا يجوز لأحد تسمية هذه الطريقة سوى معلّم الدورة التدريبية الذي يحتوي على الواجب الدراسي.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بالوصول إلى الدورة التدريبية أو عمل الدورة الدراسية المطلوب أو بسبب أخطاء في الوصول.INVALID_ARGUMENT
إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.NOT_FOUND
إذا لم يكن عمل الدورة الدراسية أو الدورة التدريبية المطلوب متاحًا.
طلب HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}:modifyAssignees
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
courseId |
معرّف الدورة التدريبية. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو |
id |
معرّف الدورة الدراسية. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "assigneeMode": enum ( |
الحقول | |
---|---|
assigneeMode |
نموذج لمهام الدورة الدراسية يصف ما إذا كان سيتم إسنادها لجميع الطلاب أو لطلاب معيّنين محدّدين. |
modifyIndividualStudentsOptions |
يمكنك تحديد الطلاب الذين تم تكليفهم بواجب الدورة الدراسية أو الذين لم يتم تكليفهم به. يجب تحديد قيمة السمة |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال CourseWork
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.coursework.students
لمزيد من المعلومات، راجِع دليل التفويض.