دانشآموزان و معلمان نگاشتهای خاصی بین نمایه کاربر و یک دوره هستند که نشاندهنده نقش آن کاربر در دوره هستند. تعیین دانش آموز و معلم جهانی نیست: یک کاربر می تواند به عنوان معلم برای یک دوره و یک دانش آموز در درس دیگر اختصاص داده شود. نام "دانشجو" یا "معلم" مجموعه ای از مجوزها را برای یک کاربر خاص در یک دوره خاص نشان می دهد.
- دانش آموزان
- یک منبع دانشجویی نشان دهنده کاربری است که به عنوان دانشجو در یک دوره خاص ثبت نام کرده است. دانش آموزان مجاز به مشاهده جزئیات دوره و اساتید آن دوره هستند.
- معلمان
- یک منبع معلم نشان دهنده کاربری است که دوره خاصی را تدریس می کند. معلمان مجاز به مشاهده و تغییر جزئیات دوره، مشاهده معلمان و دانش آموزان و مدیریت معلمان و دانش آموزان اضافی هستند.
دانشآموزان و معلمان با شناسه منحصربهفرد یا آدرس ایمیل کاربر، همانطور که توسط Directory API بازگردانده میشود، شناسایی میشوند. کاربر فعلی همچنین ممکن است با استفاده از خلاصه "me"
به شناسه خود مراجعه کند.
اضافه کردن مستقیم
مدیران دامنه مجاز به دور زدن جریان دعوت و افزودن مستقیم کاربران در دامنه خود به عنوان معلم یا دانش آموز به دوره های آموزشی در دامنه خود هستند. در صورتی که صاحب دوره در دامنه مدیریت باشد، یک دوره در دامنه ادمین در نظر گرفته می شود. برای کاربران یا دورههای خارج از دامنه یک مدیر دامنه تأیید شده، برنامهها باید رضایت کاربر را با ارسال دعوتنامه با متد invitations.create()
دریافت کنند.
معلمان را اضافه یا حذف کنید
همانطور که در نمونه زیر نشان داده شده است، مدیران دامنه میتوانند مستقیماً معلمان درون دامنه خود را به دورههایی با teachers.create()
اضافه کنند:
دات نت
جاوا
PHP
پایتون
اگر معلمهای دیگری را از طرف یک معلم تأیید شده اضافه میکنید، باید از متد invitations.create()
استفاده کنید.
شما می توانید معلمان اضافی را از یک دوره با متد teachers.delete()
حذف کنید. این فقط معلم مشخص شده را از دوره حذف می کند و بر تکلیف آنها به دوره های دیگر یا نمایه کاربری آنها تأثیری ندارد.
ثبت نام یا حذف دانش آموزان
همانطور که در نمونه زیر نشان داده شده است، مدیران دامنه می توانند مستقیماً با متد students.create()
دانش آموزان را در دامنه خود اضافه کنند:
دات نت
جاوا
PHP
پایتون
اگر از طرف یک معلم تأیید شده دانش آموزان را اضافه می کنید، باید از متد invitations.create()
استفاده کنید.
می توانید با متد students.delete()
یک دانش آموز را از یک دوره حذف کنید. این فقط دانش آموز مشخص شده را از دوره حذف می کند و تأثیری بر ثبت نام وی در سایر دوره ها یا پروفایل کاربری آنها ندارد.
دوره های یک کاربر را بازیابی کنید
برای بازیابی لیستی از دوره ها برای یک دانش آموز یا معلم، courses.list()
را فراخوانی کنید و studentId
یا teacherId
کاربر مربوطه را تهیه کنید.
بازیابی نمایه یک کاربر
برای بازیابی نمایه خلاصه شده، از جمله شناسه و نام، برای کاربر، با شناسه کاربر، ایمیل یا "me" برای کاربر درخواست کننده، با userProfiles.get()
تماس بگیرید.
برای بازیابی فیلد emailAddress
، باید محدوده classroom.profile.emails
را وارد کنید.
شناسه برگشتی مربوط به منبع Directory API Users است که حاوی studentId
یا teacherId
منطبق است.
مدیریت صاحبان دوره
مدیران دامنه می توانند مالکیت دوره ها را بین معلمان منتقل کنند. لطفاً برای جزئیات مهم بخش انتقال مالکیت دوره را ببینید.