تمثّل أدوار الطالب والمعلّم في Google Classroom دور المستخدم في أحد المقررات التعليمية. يمكن تعيين مستخدم كمعلّم في دورة دراسية و طالبًا في دورة أخرى. يمثّل التصنيف "طالب" أو "معلم" مجموعة من الأذونات لمستخدم معيّن في دورة تدريبية معيّنة.
- الطلاب
- يمثّل مورد
Student
مستخدمًا مسجّلاً كطالب في دورة تدريبية معيّنة. يُسمح للطلاب بالاطّلاع على تفاصيل الدورة واطلاعهم على اسماء المعلّمين فيها. - المعلمون
- يمثّل مورد
Teacher
مستخدمًا يقدّم دورة تدريبية معيّنة. يُسمح للمعلّمين بعرض تفاصيل الدورة التدريبية وتغييرها، والاطّلاع على المعلّمين والطلاب، وإدارة المعلّمين والطلاب الإضافيين. تتضمّن كل دورة تدريبية معلمًا أساسيًا أو مالكًا للدورة التدريبية، وهو معلّم يمكنه إدارة الإعدادات، مثل نقل ملكية الدورة التدريبية.
يتم تحديد الطلاب والمعلّمين من خلال المعرّف الفريد أو عنوان البريد الإلكتروني للمستخدِم، كما تعرضه Directory API.
يمكن للمستخدم الحالي أيضًا الإشارة إلى معرّفه باستخدام الاختصار "me"
.
أذونات الإدارة المباشرة باستخدام Classroom API
يحصل المشرفون والطلاب والمعلّمون على أذونات مختلفة عند إضافة مستخدمين إلى الدورات التدريبية أو إزالتهم منها مباشرةً باستخدام Classroom API.
المشرفون
يُسمح لمشرفي النطاقات بتخطّي عملية الدعوة وإضافة الطلاب والمعلّمين مباشرةً إلى دورة تدريبية في حال استيفاء الشروط التالية:
- المستخدم الذي تتم إضافته هو جزء من نطاق المشرف.
- المعلّم الأساسي للدورة التدريبية، أو مالك الدورة التدريبية، هو جزء من نطاق المشرف.
بالنسبة إلى المستخدمين أو الدورات التدريبية خارج نطاق المشرف، يجب أن تحصل التطبيقات على موافقة المستخدم من خلال إرسال دعوة باستخدام invitations.create()
.
الطلاب
يمكن للطلاب إضافة أنفسهم إلى دورة تدريبية من خلال الاتصال برقم students.create()
وتحديد enrollmentCode
للدورة التدريبية. enrollmentCode
هو معرّف فريد للدورة الدراسية التي يتم
تضمينها في المورد Course
. في تطبيق الويب
Classroom، يتوفّر الرمز enrollmentCode
في علامة تبويب "البث" وصفحة
تفاصيل الدورة التدريبية.
المعلمون
لا يمكن للمعلّمين إضافة مستخدمين إلى دورة تدريبية مباشرةً، ويجب استخدام invitations.create()
لدعوة الطلاب والمعلّمين الآخرين إلى الدورة التدريبية.
يوضّح الجدول التالي المستخدم المسموح له بتقديم طلبات إلى الطريقتَين
create
وdelete
لموارد Teacher
وStudent
.
المشرف | معلّم | طالب | |
---|---|---|---|
CreateTeacher |
✔️ | ✖️ | ✖️ |
DeleteTeacher |
✔️ | ✔️ | ✖️ |
CreateStudent |
✔️ | ✖️ | ✔️ 1 |
DeleteStudent |
✔️ | ✔️ | ✔️ 2 |
1 يمكن للطالب إضافة نفسه إلى دورة تدريبية فقط.
2 يمكن للطالب حذف نفسه من الدورة التدريبية فقط.
إدارة المعلّمين
يمكن لمشرفي النطاق إضافة المعلّمين في نطاقاتهم مباشرةً إلى الدورات التدريبية
باستخدام teachers.create()
، كما هو موضّح في المثال التالي:
يمكن للمعلّمين المساعدين إزالة معلّمين آخرين من دورة تدريبية باستخدام الطريقة
teachers.delete()
. يؤدي هذا الإجراء إلى إزالة المدرّس المحدّد فقط من الدورة التدريبية، ولا يؤثر في تعيينه لدورات تدريبية أخرى أو في ملفه الشخصي.
إدارة مالكي الدورات التدريبية
يمكن لمشرفي النطاق نقل ملكية الدورات التدريبية بين المعلّمين. اطّلِع على قسم تعديل مالك الدورة التدريبية للاطّلاع على مزيد من التفاصيل المهمة.
إدارة الطلاب
يمكن لمشرفي النطاق إضافة الطلاب مباشرةً ضمن نطاقهم باستخدام أسلوب
students.create()
. إذا كان الطالب يضيف نفسه مباشرةً
إلى دورة تدريبية، يجب إدخال enrollmentCode
.
عند إزالة طالب من دورة تدريبية باستخدام students.delete()
، لا تتم إزالته إلا من الدورة التدريبية المحدّدة ولا تؤثّر في تسجيله في الدورات التدريبية الأخرى أو في ملفه الشخصي.
استرداد الدورات التدريبية للمستخدم
لاسترداد قائمة الدورات التدريبية لطالب أو معلّم، اتصل بالرقم
courses.list()
وقدِّم studentId
أو teacherId
للمستخدم المقابل.
استرداد ملف شخصي للمستخدم
لاسترداد الملف الشخصي لمستخدم، بما في ذلك رقم التعريف والاسم، يُرجى الاتصال برقم userProfiles.get()
مع إدخال رقم تعريف المستخدم أو عنوان بريده الإلكتروني أو "أنا" بدلاً من اسم العميل المُرسِل للطلب. لاسترداد حقل emailAddress
، يجب تضمين نطاق
classroom.profile.emails
.
يتوافق الرمز id
الذي يتم إرجاعه مع
مورد مستخدمي Directory API
الذي يحتوي على studentId
أو teacherId
المطابق.