يتيح تطبيق Classroom ثلاثة أنواع من عناصر البث:
CourseWork
وCourseWorkMaterials
وAnnouncements
. يوضّح هذا الدليل
كيفية إدارة CourseWork
، ولكن واجهات برمجة التطبيقات لجميع عناصر البث متشابهة. اطّلِع على مراجع واجهات برمجة التطبيقات لمعرفة مزيد من المعلومات عن أنواع عناصر البث واختلافاتها.
يمثّل المرجع CourseWork
عنصر عمل تم إسناده إلى
الطلاب في دورة تدريبية معيّنة، بما في ذلك أي مواد وتفصيل إضافية،
مثل تاريخ الاستحقاق أو الحد الأقصى للنتيجة. هناك أربعة أنواع فرعية من CourseWork
:
المهام ومهام الاختبارات وأسئلة الإجابة القصيرة و
أسئلة الخيارات المتعدّدة. تتيح Classroom API استخدام
ثلاثة من هذه الأنواع الفرعية: المهام والأسئلة ذات الإجابات القصيرة
والأسئلة بخيارات متعدّدة. يتم تمثيل هذه الأنواع من خلال الحقل
CourseWork.workType
.
بالإضافة إلى مورد CourseWork
، يمكنك إدارة العمل المكتمل
باستخدام مورد StudentSubmission
.
إنشاء CourseWork
لا يمكن إنشاء CourseWork
إلا نيابةً عن معلّم الدورة التدريبية.
تؤدي محاولة إنشاء CourseWork
نيابةً عن طالب أو مشرف نطاق
ليس معلّمًا في الدورة التدريبية إلى خطأ
PERMISSION_DENIED
. اطّلِع على أنواع المستخدمين لمعرفة المزيد من المعلومات عن الدوار المختلفة
في Classroom.
عند إنشاء CourseWork
باستخدام الطريقة courses.courseWork.create
،
يمكنك إرفاق الروابط على أنّها materials
، كما هو موضّح في الرمز البرمجي النموذجي أدناه:
Java
Python
حقلَا title
وworkType
مطلوبان. وجميع الحقول الأخرى اختيارية.
إذا لم يتم تحديد state
، يتم إنشاء CourseWork
في حالة مسودة.
استخدِم مصدر رابط مع هدف محدّد
url
لتضمين مواد مرتبطة في CourseWork
. تُسترجع واجهة برمجة تطبيقات Classroom
تلقائيًا title
وعنوان URL لصورة الصورة المصغّرة (thumbnailUrl
). تتيح واجهة برمجة التطبيقات
Classroom API أيضًا استخدام مواد Google Drive وYouTube
بشكلٍ تلقائي، ويمكن تضمينها مع مرجعملف Drive أو مرجعفيديو YouTube بطريقة مشابهة.
لتحديد تاريخ استحقاق، اضبط الحقلَين dueDate
وdueTime
على
التوقيت العالمي المنسق المقابل. يجب أن يكون تاريخ الاستحقاق في المستقبل.
يتضمّن استجابة CourseWork
معرّفًا يحدّده الخادم ويمكن استخدامه
للإشارة إلى عملية التخصيص في طلبات واجهة برمجة التطبيقات الأخرى.
استرداد CourseWork
يمكنك استرداد CourseWork
نيابةً عن الطلاب والمعلّمين في الدورة التدريبية
المعنية. يمكنك أيضًا استرداد CourseWork
نيابةً عن مشرفي النطاق
، حتى إذا لم يكونوا معلّمين في الدورة التدريبية. لاسترداد
CourseWork
محدّد، استخدِم courses.courseWork.get
. لاسترداد كل
CourseWork
(اختياريًا مطابقة بعض المعايير)، استخدِم
courses.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
إنّ الحصول على إذن باسترداد CourseWork
لا يعني
حصولك على أذونات للوصول إلى المواد أو البيانات الوصفية للمواد. يعني ذلك عمليًا أنّه قد لا يظهر لمشرف ما عنوان ملف مُرفَق في Drive إذا لم يكن عضوًا في الدورة التدريبية.
إدارة ردود الطلاب
يمثّل مرجع StudentSubmission
العمل الذي أنجزه طالب في أحد
CourseWork
. يتضمّن المرجع بيانات وصفية مرتبطة بالعمل، مثل
حالة العمل ودرجته. يتم تلقائيًا
إنشاء StudentSubmission
لكل طالب عند إنشاء CourseWork
جديد.
توضّح الأقسام التالية الإجراءات الشائعة التي تُدير ردود الطلاب.
استرداد ردود الطلاب
يمكن للطلاب استرداد المحتوى الذي أرسلوه، ويمكن للمعلّمين استرداد المحتوى الذي أرسله
جميع الطلاب في الدورات التدريبية التي يدرّسونها، ويمكن لمشرفي النطاق استرداد كل المحتوى الذي أرسله
جميع الطلاب في نطاقهم. يتم تحديد معرّف لكل StudentSubmission
. إذا كنت تعرف المعرّف، استخدِم
courses.courseWork.studentSubmissions.get
لاسترداد العينة التي تم إرسالها.
استخدِم طريقة courses.courseWork.studentSubmissions.list
للحصول على كل موارد
StudentSubmission
التي تتطابق مع بعض المعايير، كما هو موضّح في المثال التالي:
Java
Python
يمكنك استرداد StudentSubmission
موردًا ينتمي إلى طالب معيّن من خلال
تحديد المَعلمة userId
، كما هو موضّح في المثال التالي:
Java
Python
يتم تحديد الطلاب من خلال المعرّف الفريد أو عنوان البريد الإلكتروني، كما هو موضّح في مورد
Student
. يمكن للمستخدم الحالي أيضًا الإشارة إلى معرّفه باستخدام الاختصار
"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
إنّ الحصول على إذن لاسترداد StudentSubmission
لا يعني أنّ لديك أذونات
للوصول إلى المرفقات أو البيانات الوصفية للمرفقات. يعني ذلك عمليًا أنّه قد لا يظهر لأحد المشرفين عنوان ملف Drive مرفق إذا لم يكن عضوًا في الدورة التدريبية.
إضافة مرفقات إلى ردّ أحد الطلاب
يمكنك إرفاق روابط بأحد العناصر التي أرسلها الطالب من خلال إرفاق مرجع Link
أو
DriveFile
أو YouTubeVideo
. يتم ذلك باستخدام الرمز
courses.courseWork.studentSubmissions.modifyAttachments
، كما هو موضّح في المثال التالي:
Java
Python
يتم تحديد مرفق Link
من خلال العنصر المستهدَف url
، ويعمل Classroom على retrievingtitle
وصورة المصغّرة (thumbnailUrl
) تلقائيًا. اطّلِع على Material
للتعرّف على المواد التي يمكن إرفاقها بStudentSubmissions
.
لا يمكن تعديل StudentSubmission
إلا من قِبل معلّم الدورة التدريبية أو
الطالب الذي يملكها. لا يمكنك إرفاق Materials
إلا إذا كان
CourseWorkType
StudentSubmission
هو ASSIGNMENT
.
يعتمد النطاق المطلوب على الدور الذي يلعبه المستخدم المُقدّم للطلب في الدورة التدريبية. إذا كان المستخدم معلّمًا، استخدِم النطاق التالي:
https://www.googleapis.com/auth/classroom.coursework.students
إذا كان المستخدم طالبًا، استخدِم النطاق التالي:
https://www.googleapis.com/auth/classroom.coursework.me