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 לצרכים שלכם, ואז מגדירים את הסביבה ומתחילים לשלוח בקשות לפי אחד ממדריכי ההתחלה המהירה:
התנסות עם API Explorer של Google
כדי להתנסות בקריאה ל-methods בנתונים פעילים, אפשר להשתמש בGoogle APIs Explorer. לא צריך לכתוב קוד כדי להתחיל, אבל חשוב לדעת שפעולות שמבצעים באמצעות הכלי APIs Explorer יכולות לשנות נתונים קיימים.
אחת הדרכים להתחיל להפעיל את ה-methods היא להפעיל את ה-method courses.list(). השיטה הזו לא דורשת פרמטרים של בקשה, ואפשר לאחזר id מהרשימה של הקורסים שמוחזרת כדי להשתמש בו כפרמטר של בקשה לקריאות אחרות ל-API. אם אין לכם קורסים, תוכלו ליצור קורס באמצעות השיטה courses.create().
אפשר גם לעיין בהפניה ל-Classroom API.