תפקידי התלמידים והמורים ב-Google Classroom מייצגים את התפקיד של המשתמש בקורס. אפשר להקצות משתמש כמורה בקורס אחד וכתלמיד בקורס אחר. ההגדרה 'תלמיד/ה' או 'מורה' מייצגת קבוצת הרשאות של משתמש מסוים בקורס מסוים.
- סטודנטים
- משאב
Student
מייצג משתמש שמשויך כתלמיד לקורס ספציפי. התלמידים יכולים לראות את פרטי הקורס ואת המורים שלו. - מורים
- משאב
Teacher
מייצג משתמש שמלמד קורס ספציפי. למורים מותר להציג ולשנות את פרטי הקורס, להציג את המורים והתלמידים ולנהל מורים ותלמידים נוספים. לכל קורס יש מורה ראשי, או בעלים של הקורס, שהוא מורה שיכול לנהל את ההגדרות, כמו העברת הבעלות על הקורס.
תלמידים ומורים מזוהים לפי המזהה הייחודי או כתובת האימייל של המשתמש, כפי שהם מופיעים ב-Directory API.
המשתמש הנוכחי יכול גם להפנות למזהה שלו באמצעות קיצור הדרך "me"
.
הרשאות ניהול ישירות באמצעות Classroom API
לאדמינים, לתלמידים ולמורים יש הרשאות שונות להוספה או להסרה של משתמשים ישירות מהקורסים באמצעות Classroom API.
מנהלי מערכת
אדמינים של דומיינים יכולים לעקוף את תהליך ההזמנה ולהוסיף תלמידים ומורים לקורס באופן ישיר אם התנאים הבאים מתקיימים:
- המשתמש שנוסף הוא חלק מהדומיין של האדמין.
- המורה הראשי של הקורס, או הבעלים של הקורס, נמצא בדומיין של האדמין.
לגבי משתמשים או קורסים מחוץ לדומיין של אדמין, האפליקציות צריכות לקבל את הסכמת המשתמש על ידי שליחת הזמנה באמצעות השיטה invitations.create()
.
סטודנטים
התלמידים יכולים להוסיף את עצמם לקורס על ידי קריאה ל-students.create()
וציון enrollmentCode
של הקורס. השדה enrollmentCode
הוא מזהה ייחודי של הקורס שכלול במשאב Course
. באפליקציית האינטרנט של Classroom, הסמל enrollmentCode
זמין בכרטיסייה 'עדכונים' ובדף פרטי הקורס.
מורים
מורים לא יכולים להוסיף משתמשים ישירות לקורס, והם צריכים להשתמש בשיטה invitations.create()
כדי להזמין תלמידים ומורים אחרים לקורס.
בטבלה הבאה מפורט אילו משתמשים מורשים לשלוח בקשות ל-methods create
ו-delete
של המשאבים Teacher
ו-Student
.
אדמין | מורה | סטודנט | |
---|---|---|---|
CreateTeacher |
✔️ | ✖️ | ✖️ |
DeleteTeacher |
✔️ | ✔️ | ✖️ |
CreateStudent |
✔️ | ✖️ | ✔️ 1 |
DeleteStudent |
✔️ | ✔️ | ✔️ 2 |
1 תלמידים יכולים להוסיף את עצמם לקורס בלבד.
2 רק תלמידים יכולים למחוק את עצמם מקורסים.
ניהול המורים
מנהלי דומיינים יכולים להוסיף ישירות מורים מהדומיין שלהם לקורסים באמצעות teachers.create()
, כפי שמוצג בדוגמה הבאה:
.NET
Java
PHP
Python
מורים עמיתים יכולים להסיר מורים אחרים מהקורס באמצעות השיטה teachers.delete()
. הפעולה הזו מסירה רק את המורה שצוין מהקורס, ולא משפיעה על ההקצאה שלו לקורסים אחרים או על פרופיל המשתמש שלו.
ניהול בעלי הקורסים
אדמינים בדומיין יכולים להעביר בעלות על קורסים בין מורים. פרטים חשובים מופיעים בקטע עדכון הבעלים של הקורס.
ניהול התלמידים
אדמינים בדומיין יכולים להוסיף תלמידים ישירות בדומיין שלהם באמצעות השיטה students.create()
. אם התלמידים מוסיפים את עצמם ישירות לקורס, צריך להשתמש ב-enrollmentCode
.
.NET
Java
PHP
Python
הסרת תלמיד או תלמידה מהקורס באמצעות השיטה students.delete()
מסירה אותם רק מהקורס שצוין, ולא משפיעה על ההרשמה שלהם לקורסים אחרים או על פרופיל המשתמש שלהם.
אחזור הקורסים של משתמש
כדי לאחזר רשימת קורסים של תלמיד או מורה, צריך להפעיל את הפונקציה courses.list()
ולספק את הערך של studentId
או teacherId
של המשתמש הרלוונטי.
אחזור פרופיל של משתמש
כדי לאחזר את הפרופיל של משתמש, כולל מזהה ושם, צריך להפעיל את הפונקציה userProfiles.get()
ולציין את המזהה, כתובת האימייל או 'אני' של המשתמש המבקש. כדי לאחזר את השדה emailAddress
, צריך לכלול את ההיקף classroom.profile.emails
.
הערך המוחזר של id
תואם למשאב Directory API Users שמכיל את studentId
או teacherId
התואמים.