תלמידים ומורים הם מיפויים ספציפיים בין פרופיל משתמש לקורס, שמייצגים את התפקיד של המשתמש בקורס. ההגדרות 'תלמיד/ה' ו'מורה' לא גלובאליות: אפשר להקצות משתמש כתלמיד בקורס אחד וכמורה בקורס אחר. ההגדרה 'תלמיד/ה' או 'מורה' מייצגת קבוצת הרשאות של משתמש מסוים בקורס מסוים.
- סטודנטים
- משאב 'תלמיד/ה' מייצג משתמש שמשויך כתלמיד/ה לקורס ספציפי. התלמידים יכולים לראות את פרטי הקורס ואת המורים שלו.
- מורים
- משאב מורה מייצג משתמש שמלמד קורס ספציפי. למורים מותר להציג ולשנות את פרטי הקורס, להציג את המורים והתלמידים ולנהל מורים ותלמידים נוספים.
התלמידים והמורים מזוהים לפי המזהה הייחודי או כתובת האימייל של המשתמש, כפי שהם מוחזרים על ידי 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
התואמים.
ניהול בעלי הקורסים
אדמינים בדומיין יכולים להעביר את הבעלות על קורסים בין מורים. פרטים חשובים מופיעים בקטע העברת הבעלות על קורס.