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.