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