תלמידים ומורים הם מיפויים ספציפיים בין פרופיל משתמש לקורס, והם מייצגים את תפקיד המשתמש בקורס. ההקצאה של תלמיד ומורה אינה גלובלית: אפשר להקצות משתמש כמורה בקורס אחד ותלמיד בקורס אחר. הכינוי "תלמיד" או "מורה" מייצג קבוצה של הרשאות למשתמש מסוים בקורס מסוים.
- סטודנטים
- משאב של תלמיד מייצג משתמש שרשום כתלמיד בקורס ספציפי. לתלמידים מותר לראות את פרטי הקורס וצוותי ההוראה שלו.
- מורים
- משאב למורה מייצג משתמש שמלמד קורס ספציפי. מורים יכולים לראות ולשנות את פרטי הקורס, להציג מורים ותלמידים ולנהל מורים ותלמידים נוספים.
המערכת מזהה את התלמידים והמורים באמצעות המזהה הייחודי או כתובת האימייל של המשתמש, כפי שמוחזר ב-Directory API.
המשתמש הנוכחי יכול גם לעיין במזהה שלו באמצעות הקיצור "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()
ולציין את המזהה, כתובת האימייל או המילה "me" של המשתמש שביקש אותו.
כדי לאחזר את השדה emailAddress
, צריך לכלול את ההיקף classroom.profile.emails
.
המזהה שמוחזר תואם למשאב Directory API Users שמכיל את הערכים studentId
או teacherId
התואמים.
ניהול הבעלים של הקורסים
מנהלי דומיינים יכולים להעביר בעלות על קורסים בין מורים. לפרטים חשובים, קראו את הקטע העברת בעלות על קורס.