نقش دانشآموز و معلم در 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()
با شناسه کاربر، ایمیل یا "me" برای کاربر درخواست کننده تماس بگیرید. برای بازیابی فیلد emailAddress
، باید محدوده classroom.profile.emails
را وارد کنید.
id
برگشتی مربوط به منبع Directory API Users است که حاوی studentId
یا teacherId
منطبق است.