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 של OneRoster שמסתיימת ב-
/ims/oneroster/v1p2 - 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 שמשמש לסינון על סמך כתובת אימייל של מורה. האימייל יישלח לכתובת האימייל של המורה שסיפקתם בקטע 'פרטי הכניסה' של הבדיקות. |
| Classes: 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} לא נדרשת. הוא אופציונלי ומשמש לניקוי נתונים. נקודת הקצה (endpoint) הבאה GET /classes/{class_sourced_id}/lineItems היא גם אופציונלית, והיא בודקת שפריט הקו נמחק. |
שיתוף תוצאות הבדיקה עם צוות Google Classroom
אחרי שמריצים את הבדיקות, נוצר דוח מלא עם התוצאות של כל בדיקה. הבדיקות האלה משמשות כדי לקבוע אם המוצר שלכם עומד בדרישות השימוש ב-OneRoster 1.2 של Google. אפשר להוריד את הדוח שנוצר או לצלם צילום מסך שלו כדי לשתף אותו עם צוות Google Classroom.
קבלת תמיכה
אם יש לך שאלות, אפשר לשלוח אימייל לכתובת classroom-sis-external@google.com.