الطلاب والمعلّمون هم عمليات ربط محدّدة بين ملف شخصي لمستخدم ودورة تدريبية، ما يمثّل دور هذا المستخدم في الدورة التدريبية. إن تعيينات الطلاب والمعلمين ليست عامة: حيث يمكن تعيين المستخدم كمدرس لدورة تدريبية والطالب في دورة أخرى. يمثل التصنيف "طالب" أو "مُعلّم" مجموعة من الأذونات لمستخدم معيّن في دورة تدريبية معيّنة.
- الطلاب
- يمثل مورد الطالب المستخدم الذي تم تسجيله كطالب في دورة تدريبية محدّدة. يُسمح للطلاب بالاطّلاع على تفاصيل الدورة التدريبية ومعلّمي هذه الدورة التدريبية.
- المعلمون
- يمثل مورد المعلّم مستخدمًا يدرّس دورة تدريبية معيّنة. يُسمح للمعلمين بعرض تفاصيل الدورة التدريبية وتغييرها، وعرض المعلمين والطلاب، وإدارة المزيد من المعلمين والطلاب.
ويتم تعريف الطلاب والمعلّمين من خلال رقم التعريف الفريد أو عنوان البريد الإلكتروني للمستخدم، كما هو وارد في واجهة برمجة تطبيقات الدليل.
يمكن للمستخدم الحالي أيضًا الإشارة إلى رقم تعريفه باستخدام اختصار "me"
.
الإضافة المباشرة
يُسمح لمشرفي النطاق بتجاوز تدفق الدعوة وإضافة المستخدمين ضمن نطاقهم مباشرة كمعلمين أو طلاب إلى الدورات التدريبية ضمن نطاقهم. يتم اعتبار الدورة التدريبية ضمن نطاق المشرف إذا كان مالك الدورة التدريبية ضمن نطاق المشرف. بالنسبة إلى المستخدمين أو الدورات التدريبية خارج نطاق مشرف النطاق الذي تمت مصادقته، يجب أن تحصل التطبيقات على موافقة المستخدم عن طريق إرسال دعوة باستخدام طريقة invitations.create()
.
إضافة معلّمين أو إزالتهم
يمكن لمشرفي النطاق إضافة معلّمين داخل النطاق مباشرةً إلى الدورات التدريبية
باستخدام teachers.create()
، كما هو موضّح في العينة التالية:
NET.
لغة Java
لغة PHP
لغة Python
إذا كنت تضيف معلّمين إضافيين نيابةً عن معلّم تمت مصادقته،
يجب استخدام طريقة invitations.create()
.
يمكنك إزالة معلّمين إضافيين من الدورة التدريبية باستخدام طريقة
teachers.delete()
. يؤدي ذلك فقط إلى إزالة المُعلّم
المحدّد من الدورة التدريبية ولا يؤثر في تعيينه للدورات التدريبية الأخرى أو
الملف الشخصي للمستخدم.
تسجيل الطلاب أو إزالتهم
يمكن لمشرفي النطاق إضافة الطلاب مباشرةً ضمن نطاقهم باستخدام طريقة students.create()
، كما هو موضّح في النموذج التالي:
NET.
لغة Java
لغة PHP
لغة Python
إذا كنت تضيف طلابًا نيابةً عن معلّم تمت المصادقة عليه، عليك استخدام
طريقة invitations.create()
.
يمكنك إزالة طالب من دورة تدريبية باستخدام طريقة
students.delete()
. يؤدي ذلك إلى إزالة الطالب المحدد فقط من الدورة التدريبية ولا يؤثر على تسجيله في الدورات التدريبية الأخرى أو في الملف الشخصي للمستخدم.
استرداد الدورات التدريبية لأحد المستخدمين
لاسترداد قائمة الدورات التدريبية لطالب أو معلّم، يمكنك التواصل مع
courses.list()
وتقديم الخاصية المناسبة للمستخدم
studentId
أو teacherId
.
استرداد الملف الشخصي لمستخدم
لاسترداد الملف الشخصي المختصر، بما في ذلك رقم التعريف والاسم، يُرجى الاتصال على
userProfiles.get()
وتقديم رقم تعريف المستخدم أو البريد الإلكتروني أو "أنا"
للمستخدم المطلوب.
لاسترداد الحقل emailAddress
، يجب تضمين النطاق classroom.profile.emails
.
يتطابق المعرّف المعروض مع
مورد مستخدمي واجهة برمجة تطبيقات الدليل
الذي يحتوي على المطابقة studentId
أو teacherId
.
إدارة مالكي الدورة التدريبية
يمكن لمشرفي النطاق نقل ملكية الدورات التدريبية بين المعلمين. يُرجى الاطّلاع على قسم نقل ملكية الدورة التدريبية لمعرفة التفاصيل المهمة.