Google Classroom תומך בסנכרון של גיליון הציונים ובייבוא של רשימת התלמידים למספר מערכות לניהול מידע על תלמידים (SIS) שתואמות ל-OneRoster. Google משתפת פעולה עם פלטפורמות SIS שעומדות בדרישות OneRoster שצוינו על ידי Google.
השותפות עם Classroom מאפשרת לאדמינים לקשר את הכיתות שלהם ב-Classroom למערכת ה-SIS שלכם.
איור 1. כשמערכות לניהול מידע על תלמידים (SIS) משתפות פעולה עם Classroom, האדמינים יכולים לבחור את מערכת ה-SIS בתפריט הנפתח.
תהליך הפיתוח של שותף SIS
אם אתם רוצים לשתף פעולה עם Classroom, אתם יכולים למלא את טופס ההתעניינות.
הצוות של Classroom יצר סדרה של בדיקות תאימות ששותפי SIS שמתעניינים בכך יכולים להשתמש בהן כדי להכיר את הדרישות של Google. אתם יכולים להריץ את בדיקות התאימות לפני שפונים לצוות של Classroom כדי לבדוק עד כמה המוצר שלכם עומד בדרישות של Google.
קבלת דומיין הדגמה למפתחים
יכול להיות שתרצו לגשת למופע פעיל של Google Classroom כדי ליצור שילוב ולאמת אותו. משתמשי הבדיקה שעומדים בדרישות צריכים להיות בעלי מהדורת Plus של Google Workspace for Education. אם אין לכם גישת אדמין לדומיין של Google Workspace for Education עם הרישיונות האלה, אתם צריכים לבצע את השלבים לקבלת דומיין בדיקה למפתחים ולשליחת בקשה לשדרוג דומיין הדגמה. בדומיין שלכם יוקצו 10 רישיונות ל-Google Workspace for Education Plus.
גישה לבדיקות והרצה שלהן
כדי להריץ את הבדיקות, צריך:
- כתובת ה-URL של הטוקן לאחזור פרטי כניסה מסוג OAuth 2.0
- כתובת URL של One Roster שמסתיימת ב-
/ims/oneroster/v1p1 - Client-ID
- סוד לקוח
- כתובת אימייל של מורה
אפשר להריץ את הבדיקות באמצעות Google Colab או Jupyter notebook. גם ב-Colab וגם ב-Jupyter notebook אפשר להריץ את כל הבדיקות בבת אחת. כך תוכלו ליצור את תוצאות הבדיקה ולשתף אותן עם צוות Google Classroom.
דרישות לגבי מערכות SIS והתנהגות צפויה
הבדיקות שמוגדרות על ידי Google נועדו לספק לשותפי SIS שמתעניינים בכך דרך לקבוע אם המוצר שלהם עומד בדרישות השימוש ב-OneRoster של Google, ולמזער את השגיאות שמשתמשים עלולים להיתקל בהן כשהם משתמשים בשילובים של SIS ב-Classroom. כדאי לקרוא את ההסברים הבאים על הבדיקות. ב-GitHub, לכל בדיקה יש שם שאליו יש הפניות במצביעים. חשוב לזכור שההסברים האלה יכולים לעזור להבין את השאלות, אבל הם לא רשימה מלאה של הבדיקות. מוודאים שהפעלתם את כל הבדיקות שמופיעות ב-GitHub.
| בדיקה | הערות |
|---|---|
| מורים: GetAllTeachers | נקודת הקצה GET /teachers נקראת עם פרמטר השאילתה limit. בבדיקות הבאות, הפרמטר הזה משמש כדי לוודא שהמוצר יכול לתמוך בגודל דף של 10,000. |
| מורים: GetAllTeachers עם מסנן אימייל | נקודת הקצה GET /teachers נקראת עם פרמטר השאילתה filter שמשמש לסינון על סמך כתובת אימייל של מורה. האימייל יישלח לכתובת האימייל של המורה שסיפקתם בקטע 'פרטי הכניסה' של הבדיקות. |
| כיתות: GetClassesForTeacher | נקודת הקצה /teachers/{teacher_sourced_id}/classes נקראת עם פרמטר השאילתה filter שמשמש לסינון על סמך שיעורים פעילים. |
| תלמידים: GetStudentsForClass | נקודת הקצה GET /classes/{class_sourced_id}/students נקראת. צריך להחזיר את האימייל של התלמיד/ה בתשובה. |
| GetGradingPeriodsForTerm | התמיכה בתקופות למתן ציונים נבדקת באמצעות term_sourced_id. ה-term_sourced_id הזה משמש לאחזור התקופות למתן הציונים בסמסטר על ידי קריאה לנקודת הקצה GET terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | כשמתקשרים אל PUT /lineItems/{line_item_sourced_id}, לא צריך להגדיר תקופות למתן ציונים. |
| LineItem: Edit | הקריאה ל-API לא אמורה להחזיר שגיאה אם אורך הכותרת של המטלה ארוך. הבדיקה כוללת שם של מטלה באורך של 100 תווים ומעלה. |
| תוצאה: עריכה | אפשר להגדיר את score לערך שגדול מ-resultValueMax כדי לייצג קרדיט נוסף. |
| תוצאה: מחיקה | חובה לציין את נקודת הקצה DELETE /results/{result_sourced_id}. |
| LineItem (אופציונלי / ניקוי): מחיקה וקבלת נתונים | נקודת הקצה DELETE /lineItems/{line_item_sourced_id} לא נדרשת. הוא אופציונלי ומשמש לניקוי נתונים. נקודת הקצה הבאה GET /classes/{class_sourced_id}/lineItems היא גם אופציונלית, והיא בודקת שפריט הקו נמחק. |
שיתוף תוצאות הבדיקה עם צוות Google Classroom
אחרי שמריצים את הבדיקות, נוצר דוח מלא עם התוצאות של כל בדיקה. הבדיקות האלה משמשות כדי לקבוע אם המוצר שלכם עומד בדרישות השימוש ב-OneRoster 1.2 של Google. מורידים את הדוח שנוצר או מצלמים צילום מסך שלו כדי לשתף אותו עם צוות Google Classroom.
קבלת תמיכה
אם יש לכם שאלות, אפשר לשלוח אימייל לכתובת classroom-sis-external@google.com.