כדי לשלב את SIS עם Classroom, עליכם לוודא שהמוצר עומד בדרישות השותפות של Classroom על ידי הרצת בדיקות התאימות שסופקו.
גישה לבדיקות והפעלה שלהן
אתם יכולים לגשת לבדיקות התאימות ב-GitHub. כדי להריץ את הבדיקות:
- כתובת URL לאסימון לאחזור פרטי כניסה של OAuth 2.0
- כתובת URL אחת של רשימת תלמידים המסתיימת ב-
/ims/oneroster/v1p1
- Client ID
- סוד לקוח
- כתובת האימייל של המורה
חבילת הבדיקה כוללת שלושה חלקים:
- סנכרון ציונים בסיסי
- קטגוריות ציונים
- תקופות למתן ציונים
אתם יכולים להריץ את הבדיקות באמצעות Google Colab או Jupyter notebook. גם Colab וגם ה-notebook של Jupyter מאפשרים להריץ את כל הבדיקות בבת אחת. כך אפשר ליצור את תוצאות הבחינה כדי לשתף אותה עם צוות Google Classroom.
דרישות ב-SIS והתנהגות צפויה
מטרת הבדיקות שמוגדרות על ידי Google היא לשמור על עקביות ולצמצם את כמות השגיאות שהמשתמשים עשויים להיתקל בהן במהלך השימוש בשילובים של SIS עם Classroom. ריכזנו כאן כמה טיפים לגבי הבדיקות. ב-GitHub, כל בדיקה מסומנת ב-@title
. הכותרות האלה מוזכרות בנקודות.
שימו לב לקטעים הבאים לגבי הקטע סנכרון ציונים בסיסי:
בבדיקה של
GetAllTeachers
, נקודת הקצהGET /teachers
מופעלת עם פרמטר שאילתהlimit=
. בבדיקות הבאות נעשה שימוש בפרמטר הזה כדי לוודא שהמוצר יכול לתמוך בגודל דף של 10,000 דפים.בבדיקה של
GetAllTeachers with email filter
, נקודת הקצהGET /teachers
מופעלת עם פרמטר שאילתהfilter=
שמשמש לסינון על סמך כתובת האימייל של המורה. תצטרכו לציין כתובת אימייל של מורה כשאתם מריצים את הבדיקות.בבדיקה של
GetClassesForTeacher
, נקודת הקצה/teachers/{teacher_sourced_id}/classes
מופעלת עם פרמטר שאילתהfilter=
שמשמש לסינון על סמך מחלקות פעילות.בבדיקה של
GetStudentsForClass
מתבצעת קריאה לנקודת הקצהGET /classes/{class_sourced_id}/students?limit=10000
. יש להחזיר את כתובת האימייל של התלמיד/ה בתשובה.בבחינה של
PutLineItem Create
, לא צריך לציין קטגוריות של ציונים או תקופות למתן ציונים כשמתקשרים אלPUT /lineItems/{line_item_sourced_id}
.בבדיקה של
PutLineItem Edit
, הקריאה ל-API לא אמורה להחזיר שגיאה אם כולל אורך כותרת ארוך של ההקצאה. הבדיקה כוללת כותרת של המטלה באורך של יותר מ-100 תווים.בבדיקה של
PutResult Edit
כדאי להגדיר ל-score
ערך גדול יותר מ-resultValueMax
כדי לייצג קרדיט נוסף.נקודת הקצה
DELETE /results/{result_sourced_id}
נדרשת ונבדקת בבדיקה שלDeleteResult
.לא חובה להזין את נקודת הקצה
DELETE /lineItems/{line_item_sourced_id}
. היא אופציונלית ומשמשת לניקוי נתונים.
שימו לב לקטעים קטגוריות ציונים ותקופות למידה:
- צריך רק נקודת קצה אחת של
GET /categories
. אם אתם מריצים את כל בדיקות התאימות בבת אחת, כדאי לכתוב על כך בהערה:/categories?limit=10000
/classes/{class_sourced_id}/categories?limit=10000
- התמיכה בתקופות למתן ציונים נבדקת על ידי אחזור הקריטריון
term_sourced_id
במבחןGetAllClasses w/ filter
.term_sourced_id
משמש לאחזור התקופות למתן ציונים במונח על ידי קריאה לנקודת הקצהGET terms/{term_sourced_id}/gradingPeriods?limit=10000
בבדיקהGetGradingPeriodsForTerm
.
- צריך רק נקודת קצה אחת של
שיתוף תוצאות הבחינה עם צוות Google Classroom
אחרי שמריצים את הבדיקות, נוצר דוח מלא עם התוצאות של כל בדיקה. הבדיקות האלה עוזרות לקבוע אם המוצר עומד בדרישות הצריכה של OneRoster 1.1 של Google. מורידים או מצלמים צילום מסך של הדוח שנוצר. שולחים את הדוח וקישור לאישור של OneRoster 1.1 של המוצר לכתובת classroom-sis-external@google.com.
קבלת תמיכה
אם יש לכם שאלות או חששות, תוכלו לשלוח אימייל לכתובת classroom-sis-external@google.com.