يتيح واجهة مستخدم Classroom خمسة أنواع من المهام الدراسية: المهام الدراسية،
ومهام الاختبارات، والأسئلة ذات الإجابات القصيرة، والأسئلة ذات الخيارات المتعدّدة،
والمواد. تتيح Classroom API حاليًا ثلاثة من هذه الأنواع، والتي تُعرف باسم CourseWorkType
لواجهة برمجة التطبيقات: المهام والأسئلة ذات الإجابات القصيرة والأسئلة ذات الخيارات المتعدّدة.
للوصول إلى هذه الوظيفة، يمكنك استخدام مورد CourseWork، الذي يمثّل مهمة أو سؤالًا تم تكليف الطلاب بتنفيذه في دورة تدريبية معيّنة، بما في ذلك أي مواد وتفاصيل إضافية، مثل تاريخ التسليم أو الدرجة القصوى.
بالإضافة إلى مرجع CourseWork، يمكنك إدارة المهام المكتملة
باستخدام مرجع StudentSubmission
. توضّح الأقسام التالية هذه النقاط بمزيد من التفصيل.
إنشاء المهام
يمكن إنشاء الواجبات فقط نيابةً عن المعلّمين في الدورة التدريبية، ومحاولة إنشاء واجبات في دورة تدريبية نيابةً عن طالب سيؤدي إلى PERMISSION_DENIED
خطأ 403. وبالمثل، لا يمكن لمشرفي النطاق أيضًا إنشاء assignments للدورات التدريبية التي لا يدرّسونها، ومحاولة إجراء ذلك من خلال واجهة برمجة التطبيقات
ستؤدي أيضًا إلى ظهور خطأ 403 PERMISSION_DENIED
.
عند إنشاء المهام باستخدام طريقة courses.courseWork.create
،
يمكنك إرفاق الروابط على النحو التالي: materials
، كما هو موضّح في نموذج الرمز البرمجي أدناه:
Java
Python
تتضمّن النتيجة معرّفًا يحدّده الخادم ويمكن استخدامه للإشارة إلى عملية التخصيص في طلبات واجهة برمجة التطبيقات الأخرى.
لتضمين مواد مرتبطة في مهمة تم إنشاؤها من خلال Classroom API، استخدِم مورد رابط، مع تحديد عنوان URL المستهدف. تحصل Classroom تلقائيًا على العنوان والصورة المصغّرة. تتيح Classroom API أيضًا استخدام مواد Google Drive وYouTube بشكلٍ أصلي، ويمكن إدراجها باستخدام مورد DriveFile أو مورد YouTubeVideo بطريقة مشابهة.
لتحديد تاريخ استحقاق، اضبط الحقلَين dueDate
وdueTime
على
التوقيت العالمي المنسق المقابل. يجب أن يكون تاريخ الاستحقاق في المستقبل.
استرداد المهام والأسئلة
يمكنك استرداد المهام والأسئلة للطلاب والمعلّمين في الدورة التدريبية المعنيّة أو من خلال مشرف النطاق. لاسترداد مهمة أو سؤال معيّن، استخدِم courses.courseWork.get. لاسترداد كل assignments أو questions (اختياريًا مطابقة بعض المعايير)، استخدِم courseWork.list.
يعتمد النطاق المطلوب على الدور الذي يلعبه المستخدم الذي يطلب إذن الوصول في الدورة التدريبية. إذا كان المستخدم طالبًا، استخدِم أحد النطاقَين التاليَين:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
إذا كان المستخدم معلّمًا أو مشرف نطاق، استخدِم أحد النطاقات التالية:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
لا يعني الحصول على إذن باسترداد مهمة أو سؤال أنّه تم منح أذونات للوصول إلى المواد أو البيانات الوصفية للمواد. يعني ذلك عمليًا أنّه قد لا يظهر لمشرف ما عنوان ملف Drive مرفق إذا لم يكن عضوًا في الدورة التدريبية. إذا كنت تريد السماح للمشرفين بالوصول إلىملفّات المستخدمين، اطّلِع على دليل تفويض الصلاحيات على مستوى النطاق.
إدارة ردود الطلاب
يمثّل StudentSubmission
المورد العمل الذي أنجزه الطالب ودرجته في مهمة أو
سؤال. يتم إنشاء مورد StudentSubmission
بشكل ضمني لكل طالب عند إنشاء سؤال أو
مَهمّة جديدة.
توضّح الأقسام التالية الإجراءات الشائعة التي تُدير ردود الطلاب.
استرداد ردود الطلاب
يمكن للطلاب استرداد المحتوى الذي أرسلوه، ويمكن للمعلّمين استرداد المحتوى الذي أرسله
جميع الطلاب في الدورات التدريبية التي يدرّسونها، ويمكن لمشرفي النطاق استرداد كل المحتوى الذي أرسله
جميع الطلاب في نطاقهم. يتم تحديد معرّف لكلّ عمل يرسله الطالب. إذا كنت تعرف المعرّف، استخدِم courses.courseWork.studentSubmissions.get
لاسترداده.
استخدِم طريقة courses.courseWork.studentSubmissions.list
للحصول على موارد
StudentSubmission
تتطابق مع بعض المعايير، كما هو موضّح في المثال التالي:
Java
Python
استرجع مراجع StudentSubmission
التي تخصّ طالبًا معيّنًا من خلال
تحديد المَعلمة userId
، كما هو موضّح في العيّنة التالية:
Java
Python
يتم التعرّف على الطلاب من خلال المعرّف الفريد أو عنوان البريد الإلكتروني للمستخدم، على النحو الذي يعرضه حزمة تطوير البرامج (SDK) للمشرف في Google. يمكن للمستخدم الحالي أيضًا الإشارة إلى
رقم تعريفه باستخدام الاختصار "me"
.
من الممكن أيضًا الحصول على المحتوى الذي يرسله الطلاب لجميع المهام الدراسية ضمن
دورة تدريبية. لإجراء ذلك، استخدِم القيمة الثابتة "-"
كقيمة courseWorkId
، كما هو موضّح في المثال التالي:
Java
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
يعتمد النطاق المطلوب على الدور الذي يلعبه المستخدم الذي يطلب إذن الوصول في الدورة التدريبية. استخدِم النطاق التالي إذا كان المستخدم معلّمًا أو مشرف نطاق:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
استخدِم النطاق التالي إذا كان المستخدم طالبًا:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
إنّ الحصول على إذن باسترداد ملف أرسله طالب لا يعني أنّه يملك أذونات للوصول إلى المرفقات أو البيانات الوصفية للمرفقات. في الممارسة العملية، يعني ذلك أنّه قد لا يظهر للمشرف عنوان ملف Drive مرفق إذا لم يكن عضوًا في الدورة التدريبية. إذا كنت تريد السماح للمشرفين بالوصول إلى ملفات المستخدمين، اطّلِع على دليل تفويض الأذونات على مستوى النطاق.
إضافة مرفقات إلى ردّ أحد الطلاب
يمكنك إرفاق روابط بأحد العناصر التي أرسلها الطالب من خلال إرفاق مرجع Link
أو
DriveFile
أو YouTubeVideo
. يتم ذلك باستخدام
courses.courseWork.studentSubmissions.modifyAttachments
، كما هو موضّح في المثال التالي:
Java
Python
يتم تحديد مرفق الرابط من خلال عنوان URL المستهدف، وسيجلب Classroom تلقائيًا عنوان الفيديو والصورة المصغّرة. يمكنك الاطّلاع على معلومات عن المواد الأخرى في الصفحات المرجعية الخاصة بها.
لا يمكن تعديل StudentSubmission
إلا من قِبل معلّم الدورة التدريبية أو
الطالب الذي يملكه. لا يمكنك إرفاق Materials
إلا إذا كان
CourseWorkType
العينة التي أرسلها الطالب هي ASSIGNMENT
.
يعتمد النطاق المطلوب على الدور الذي يلعبه المستخدم الذي يطلب إذن الوصول في الدورة التدريبية. استخدِم النطاق التالي إذا كان المستخدم معلّمًا:
https://www.googleapis.com/auth/classroom.coursework.students
استخدِم النطاق التالي إذا كان المستخدم طالبًا:
https://www.googleapis.com/auth/classroom.coursework.me