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