OneRoster למערכות מידע על תלמידים

‫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.