ה-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 יסנכרנו מידע עם המערכת לניהול מידע על תלמידים (SIS) או יבאו מידע ממנה. | מטמיעים את 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.