Google Classroom API מספק ממשק תכנות למפתחי תוכנה, לאדמינים ולמנהלי בתי ספר לניהול משאבים ב-Google Classroom. אתם יכולים ליצור תוכנה שיוצרת, מאחזרת ומשנה קורסים ב-Classroom ואת התוכן שלהם.
דוגמאות לתרחישי שימוש טיפוסיים:
- ניהול קורסים, רשימות תלמידים ואפוטרופסים
- הוספת מטלות, הודעות לכיתה וחומרי לימוד
- הקצאת ציונים ושינוי הגדרות הציונים
- יצירת נתונים לניתוח
- הפיכת תוכן או כלים מספק חיצוני לזמינים ונגישים ב-Classroom
האם Classroom API הוא הפתרון הנכון בשבילי?
Google מספקת כמה מוצרים שיעזרו לכם ליצור אינטראקציה עם Classroom. ריכזנו כאן כמה תרחישים נפוצים והמלצות לגבי מוצרים שעשויים להתאים לצרכים שלכם.
שינוי משאבים ב-Google Classroom
| תרחיש | פתרונות מומלצים |
|---|---|
| אני רוצה לנהל באופן קבוע כמות גדולה של קורסים, משתמשים או משאבים אחרים ב-Classroom. יש לי ניסיון בכתיבת קוד ובתחזוקה של תשתית תוכנה. | לכתוב אפליקציות שמשתמשות ב-Classroom API. |
| אני רוצה לנהל מדי פעם נפח קטן של משאבים ב-Classroom. אני יודע לכתוב קוד בכמויות קטנות עם תקורה נמוכה. | שימוש ב-Classroom API עם Google Apps Script. |
| אני רוצה מדי פעם לבצע שינויים במשאבים ספציפיים ב-Classroom. אני מתמצא/ת בעבודה עם פקודות טרמינל. | משתמשים ב-Google Apps Manager. |
| אני רוצה לקבל נפח גדול של דוחות עם פרטים על אירועים ב-Classroom. | משתמשים בשירות העברת נתונים ל-BigQuery. |
| אני רוצה לבצע חקירה לגבי הפעילות של המשתמשים שלי. | ליצור דוחות במסוף Admin או להשתמש ב-Reports API. |
שילוב עם Google Classroom
| תרחיש | פתרונות מומלצים |
|---|---|
| אני רוצה שהמורים והתלמידים יוכלו לראות את התוכן שלי ולהפעיל אותו ב-Classroom. | יצירת תוסף ל-Classroom. |
| אני רוצה שמורים יוכלו ללחוץ על לחצן באתר או באפליקציה שלי כדי להטמיע את התוכן שלי ב-Classroom. | ליצור תוסף ל-Classroom וקבצים מצורפים באופן אוטומטי. |
| אני רוצה שמורים יוכלו ללחוץ על כפתור באתר או באפליקציה שלי כדי לקשר לתוכן שלי ב-Classroom. | יצירת עבודה לכיתה באמצעות Classroom API או הטמעה של לחצני שיתוף ב-Classroom. |
| אני רוצה שמורים ב-Classroom יוכלו לסנכרן או לייבא מידע מהמערכת לניהול מידע על תלמידים. | מטמיעים את OneRoster for SIS או יוצרים משאבים וניגשים אליהם באמצעות Classroom API. |
תחילת העבודה
לפני שמתחילים פרויקט חדש, מומלץ למפתחים חדשים לבצע את הפעולות הבאות:
- מידע נוסף על המבנה של Classroom API
- מידע נוסף על ציונים, סוגי משתמשים, קריטריונים לזכאות של משתמשים ופעולות של אדמינים במדריכים האלה מוסברים מושגים שייחודיים ל-Google Classroom ול-Classroom API.
- הסבר על בקשות Classroom API
לפני שמתחילים לפתח, צריך לוודא שביצעתם את השלבים הנדרשים. בוחרים את ההיקפים המתאימים של Classroom API לצרכים שלכם, ואז מגדירים את הסביבה ומתחילים לשלוח בקשות לפי אחד ממדריכי ההתחלה המהירה:
התנסות ב-Google APIs Explorer
כדי להתנסות בהפעלת methods על נתונים פעילים, אפשר להשתמש בכלי Google APIs Explorer. לא צריך לכתוב קוד כדי להתחיל, אבל חשוב לדעת שפעולות שמבצעים באמצעות הכלי APIs Explorer יכולות לשנות נתונים קיימים.
אחת הדרכים להתחיל לקרוא ל-methods היא לקרוא ל-method courses.list(). השיטה הזו לא דורשת פרמטרים של בקשה, ואפשר לאחזר id מהרשימה של הקורסים שמוחזרת כדי להשתמש בו כפרמטר של בקשה לקריאות אחרות ל-API. אם אין לכם קורסים, תוכלו ליצור קורס באמצעות השיטה courses.create().
אפשר גם לעיין בהפניית Classroom API.