يمثّل دور الطالب ودور المعلّم في Google Classroom دور المستخدم في دورة تدريبية. يمكن تعيين مستخدم كمعلّم في دورة تدريبية وكطالب في دورة تدريبية أخرى. يمثّل التصنيف "طالب" أو "معلّم" مجموعة من الأذونات لمستخدم معيّن في دورة تدريبية معيّنة.
- الطلاب
يمثّل مصدر
Studentمستخدمًا مسجّلاً كطالبفي دورة تدريبية معيّنة. يُسمح للطلاب بعرض تفاصيل الدورة التدريبية وأسماء المعلّمين فيها.
- المعلمون
يمثّل مصدر
Teacherمستخدمًا يدرّس دورة تدريبية معيّنة. يُسمح للمعلّمين بعرض تفاصيل الدورة التدريبية وتغييرها، وعرض أسماء المعلّمين والطلاب، وإدارة المعلّمين والطلاب الإضافيين. تحتوي كل دورة تدريبية على معلّم أساسي أو مالك الدورة التدريبية، وهو معلّم يمكنه إدارة إعدادات مثل نقل ملكية الدورة التدريبية.
يتم تحديد الطلاب والمعلّمين من خلال المعرّف الفريد للمستخدم أو عنوان بريده الإلكتروني، كما تعرضه واجهة برمجة تطبيقات الدليل.
يمكن للمستخدم الحالي أيضًا الإشارة إلى المعرّف الخاص به باستخدام الاختصار "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، كما هو موضّح في المثال التالي:
NET.
جافا
PHP
Python
يمكن للمعلّمين المساعدين إزالة معلّمين آخرين من دورة تدريبية باستخدام طريقة
teachers.delete. لا يؤدي ذلك إلا إلى إزالة المعلّم المحدّد من الدورة التدريبية ولا يؤثر في تعيينه لدورات تدريبية أخرى أو ملفه الشخصي.
إدارة مالكي الدورات التدريبية
يمكن لمشرفي النطاق نقل ملكية الدورات التدريبية بين المعلّمين. يُرجى الاطّلاع على قسم تعديل مالك الدورة التدريبية لمعرفة التفاصيل المهمة.
إدارة الطلاب
يمكن لمشرفي النطاق إضافة الطلاب مباشرةً ضمن نطاقهم باستخدام طريقة
students.create. إذا كان الطالب يضيف نفسه مباشرةً إلى دورة تدريبية، يكون enrollmentCode مطلوبًا.
NET.
جافا
PHP
Python
لا تؤدي إزالة طالب من دورة تدريبية باستخدام الـ students.delete
طريقة إلا إلى إزالته من الدورة التدريبية المحدّدة ولا تؤثر في
تسجيله في دورات تدريبية أخرى أو ملفه الشخصي.
استرداد الدورات التدريبية لمستخدم
لاسترداد قائمة بالدورات التدريبية لطالب أو معلّم، استدعِ
courses.list وقدِّم studentId
أو teacherId المقابل للمستخدم.
لا يمكنك ضبط كل من studentId وteacherId في طلب courses.list() واحد. لاسترداد قائمة بالدورات التدريبية التي تم تسجيل معلّم وطالب معيّنين فيها، قدِّم طلبات courses.list() منفصلة لكل مستخدم. بعد ذلك، ابحث عن تقاطع مجموعتَي النتائج.
استرداد الملف الشخصي لمستخدم
لاسترداد الملف الشخصي لمستخدم، بما في ذلك المعرّف والاسم، استدعِ
userProfiles.get باستخدام معرّف المستخدم أو عنوان بريده الإلكتروني أو "me" لـ
المستخدم الذي يقدّم الطلب. لاسترداد حقل emailAddress، يجب تضمين النطاق classroom.profile.emails.
يتطابق id الذي يتم عرضه مع مصدر "المستخدمون" في Directory API الذي يحتوي على
studentId أو teacherId المطابق.