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.