يُعد الطلاب والمعلّمون عمليات ربط محددة بين الملف الشخصي للمستخدم والدورة التدريبية، يمثلون دور هذا المستخدم في الدورة التدريبية. وتجدر الإشارة إلى أن تعيينات الطالب والمعلم ليست عالمية: فيمكن تعيين المستخدم كمدرس لدورة تدريبية وطالب في دورة أخرى. إنّ التصنيف "طالب" أو "معلّم" يمثّل مجموعة من الأذونات لمستخدم معيّن في دورة تدريبية معيّنة.
- الطلاب
- يمثل مورد الطالب مستخدمًا مسجَّلاً كطالب في دورة تدريبية محدّدة. ويُسمح للطلاب بعرض تفاصيل الدورة التدريبية والمعلّمين لتلك الدورة التدريبية.
- المعلمون
- يمثل مرجع "المعلّم" مستخدمًا يقدّم دورة تدريبية محدّدة. يُسمح للمعلّمين بعرض تفاصيل الدورة التدريبية وتغييرها والاطّلاع على المعلّمين والطلاب وإدارة المزيد من المعلِّمين والطلاب.
يتم تحديد الطلاب والمعلمين من خلال المعرّف الفريد أو عنوان البريد الإلكتروني للمستخدم، كما تعرضه واجهة برمجة تطبيقات الدليل.
قد يشير المستخدِم الحالي أيضًا إلى معرّفه باستخدام الاختصار "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
المطابقة.
إدارة مالكي الدورة التدريبية
يمكن لمشرفي النطاقات نقل ملكية الدورات التدريبية بين المعلّمين. يُرجى مراجعة قسم نقل ملكية الدورة التدريبية للاطّلاع على التفاصيل المهمة.