הצגה, יצירה ושינוי של CourseWork ב-Classroom
מה אפשר ליצור עם נקודות הקצה של CourseWork ב-Classroom API?
נקודות הקצה החדשות מאפשרות למפתחים להציג ולנהל את העבודה בכיתה. באופן ספציפי, תוכלו לבצע את כל הפעולות הבאות:
- להציג את המטלות והשאלות של המשתמש (שנקראות ביחד "CourseWork")
- יצירה, שינוי ומחיקה של CourseWork
- צירוף חומרים (קובצי Drive, סרטונים ב-YouTube, קישורים) ל-CourseWork
- שינוי מצב ההגשה של תלמיד (למשל: הגשה, החזרה, החזרה)
- הגדרת הציון של הגשת מטלה
- לצרף חומרים (קובצי Drive, סרטונים ב-YouTube, קישורים) להגשות שהתלמידים
דוגמאות לתרחישים לדוגמה ב-CourseWork:
- ספרי ציונים, SIS או מערכות דיווח יכולים לסנכרן מטלות וציונים מ-Classroom לאפליקציות שלהם, וכך למנוע העברת נתונים ידנית
- אפליקציות למידה יכולות ליצור מטלות חדשות שמופיעות בזרם של הכיתה. כשהתלמידים מסיימים עבודה, האפליקציות יכולות להגיש אותן, להגדיר ציונים, לצרף עבודות של תלמידים ולשמור את העבודות בתיקיות מתאימות ב-Drive.
- משתמשים המורים יכולים ליצור מטלות עם קבצים מצורפים מהאתר או מהאפליקציה.
- המשתמשים של התלמידים יכולים להגיש את המטלות שלהם, שכוללות את התוספים המצורפים.
אילו הרשאות נדרשות לאפליקציה שלי כדי ליצור או לשנות מטלות?
בדרך כלל, אפליקציה יכולה לשנות רק עבודה שהיא יוצרת. במילים אחרות, כל בקשה ל-API לשינוי הקצאה חייבת להשתמש באותו מזהה פרויקט ב-Google Cloud שנשמר בזמן יצירת ההקצאה.
לתוספים של Google Classroom יש חריגים לכלל הזה. פרויקט ב-Cloud יכול לגשת או לשנות כל הודעה, מטלה או חומר שכוללים לפחות אחד מהקבצים המצורפים לתוסף. אתם יכולים גם להגיש פרויקט ב-Cloud, להגיש מחדש מטלה או להחזיר מטלה שכוללת לפחות אחד מהקבצים שצורפו לתוסף.
לבקשות API צריך גם להגדיר את היקפי ההרשאות הנכונים של המשתמשים. המורים יכולים לצפות במטלות, ליצור מטלות, לצרף קישורים למטלות ולהגדיר ציונים למטלות. התלמידים יכולים לצפות במטלות, לצרף קישורים לרשומות של המטלות שלהם, ולהגיש את המטלות ולבטל אותן. מנהלי דומיינים יכולים לצפות ב-CourseWork, אבל אין להם הרשאות כתיבה.
אילו סוגי פריטים הבקשה שלי יכולה לצרף למטלה או להגשות?
ה-API תומך בצירוף קבצים מ-Drive, סרטונים ב-YouTube וקישורים. עדיין אין תמיכה בצירוף טפסים מקוריים מ-Google Forms.
האם משתמשי הקצה יודעים שהאפליקציה שלי יצרה מטלות ב-Classroom?
כן. בממשק המשתמש של Classroom אפשר לזהות מטלות שנוצרו באופן חיצוני באמצעות שם המוצר של הפרויקט ב-Google Cloud שיצר את העבודה. המשתמשים יכולים לדווח על עבודות שנוצרו באופן חיצוני כלא רצויות, וגם לנתק את האפליקציה שיצרה את העבודה, על ידי ביטול פרטי הכניסה שהמשתמש הנפיק לאפליקציה.
לחצן השיתוף ב-Classroom ושילובים אחרים
כבר שילבתי את לחצן השיתוף ב-Classroom. האם אפשר לשנות מטלה שנוצרה באמצעות לחצן השיתוף?
עדיין לא. כדי לשנות את המטלה, הבקשה צריכה להשתמש באותו פרויקט ב-Google Cloud שבו נוצרה ההקצאה.
האם אפשר לענות על שאלות ב-API?
עדיין לא. אפשר ליצור שאלות ולשנות אותן. אנחנו מתכננים לענות על שאלות באופן פרוגרמטי.
תוספים ל-Classroom
הגדרות אישיות של פרויקט
האם אפשר להמיר את הפרויקט הפרטי ב-Google Cloud שהשתמשתי בו במהלך הפיתוח לפרויקט ציבורי שאוכל להשתמש בו בסביבת הייצור?
לא ניתן להמיר פרויקט פרטי ב-Google Cloud לפרויקט ציבורי. צריך שני פרויקטים נפרדים, אחד לפיתוח והשני לייצור.
האם לפרויקט אחד ב-Google Cloud יכולים להיות שני דפי אפליקציות של GWM?
לא. אין אפשרות ליצור שתי רשומות GWM לפרויקט אחד ב-Google Cloud.
עם זאת, אפשר לקבץ תוספים. כך, רשימה אחת של GWM יכולה לייצג מספר תוספים. לאחר מכן, אם תתקין את התוסף הזה, תתקין בו-זמנית את כל התוספים שבחבילה. המשתמשים יצטרכו להסכים לכל היקפי ההרשאות שדרושים לתוספים בחבילה כדי לאשר את ההרשאה.
יש שני שיקולים נוספים לגבי קיבוץ:
תוספים ל-Classroom זמינים רק למנויים של Teaching & Learning Upgrade או של Education Plus.
ה-API של התוספים נמצא ב'גישה מוקדמת', ומוגבל למפתחים המשתתפים ולפרויקטים ב-Google Cloud. יכול להיות שתוספים בחבילה לא יפעלו כמו שצריך אם הם מסתמכים על פרויקטים ב-Google Cloud שלא משתתפים.
האם אפשר להשתמש שוב בלקוח OAuth מפרויקט אחר ב-Google Cloud בפרויקט ב-Google Cloud לתוספים ל-Classroom?
לא, לקוח OAuth מפרויקט ב-Google Cloud שאינו פרויקט של תוסף ל-Classroom ב-Google Cloud לא יכול לפעול. אסימוני גישה שנוצרו על ידי פרויקט אחר ב-Google Cloud נדחים על ידי Classroom API. עליכם ליצור לקוח OAuth נפרד לפרויקט של התוסף.
חוויית משתמש
הלוגו שלנו לא מתאים לריבוע קטן. מהן אפשרויות הגודל של סמלי לוגו בסרגל הכותרת של iframe?
סרגל הכותרת של iframe נועד לתמוך בלוגו ריבועי של 32x32 בלבד. הבחירה הזו נוצרה כדי להתאים לצורת סמל האתר שבה חברות משתמשות באתרים שלהן, ואנחנו ממליצים להשתמש באותו לוגו בתחום כדי לשמור על עקביות המותג.
דומיינים
האם לכל המורים והתלמידים באותו דומיין יש גישה לתוסף מותקן?
אדמינים בבתי ספר יכולים לקבוע אילו מורים יוכלו לראות תוסף מותקן.
איך מנהלי דומיינים מנהלים אינטראקציה עם תוספים?
מנהלי דומיין (מנהלי דומיין) קובעים מי יכול להשתמש בתוסף שלך. הם יכולים להתקין תוסף ברמת הדומיין באמצעות אפשרות ההתקנה של האדמין. אם אפשר להתקין תוסף ספציפי, שימו לב לרוב האדמינים יש רשימת היתרים של תוספים. מורים יכולים להתקין תוספים בעצמם שמופיעים ברשימה הזו בעצמם. יכול להיות שאדמינים יבחרו להתקין את התוסף בנפרד למטרות בדיקה.
אדמינים עשויים גם להתעניין בסטטיסטיקות שימוש לגבי התוסף. אם המוצר שלכם נתמך, מומלץ לספק סטטיסטיקות שימוש בתוסף בתצוגת אדמין באתר שלכם.
API
מהי דרך אמינה לדעת אם דף השותף נטען בתוך iframe או בכרטיסייה קופצת?
אין שיטה עדכנית להבדיל בין השניים.
אילו פריטי עבודה שאפשר להקצות מקבלים iframe של ביקורת על עבודות של תלמידים?
ה-iframe של ביקורות על עבודות של תלמידים זמין רק לקבצים מצורפים מסוג פעילות.
קוראים לשיטה courses.courseWork.getAddOnContext כדי לבדוק אם סוג הפוסט תומך בעבודה של תלמידים. השדה supportsStudentWork יכול להיות true רק לסוג פוסט שהוא פעילות.
האם יכולים להיות שינויי תוכנה שעלולים לגרום לכשלים ב-API במהלך תוכנית הגישה המוקדמת?
ה-API של התוספים עדיין נמצא בפיתוח. לכן, יכול להיות שיהיו שינויים ב-API שגורמים לכישלון או להתנהגות שונה של בקשות שהושלמו בעבר. תוכלו לקבל הודעה מראש על כל שינוי תוכנה שעלול לגרום לכשל בפורום למפתחים.
האם קובץ מצורף של תוסף יכול לגשת לפריט השידור שאליו הוא מצורף?
כן. אפשר get או patch כל Announcement, CourseWork או CourseWorkMaterial שמכילים לפחות אחד מהקבצים המצורפים לתוסף.
אפשר reclaim, return או turnIn CourseWork StudentSubmission.
מתי תוספי Classroom יושקו באופן ציבורי?
תוספים ל-Classroom זמינים לכל משתמשי הקצה מאז קיץ 2022. ממשק ה-API של התוספים צפוי להיות זמין למפתחים בכל שלב במהלך שנת 2024.
כניסה יחידה
האם תלמידים שמשתמשים בתגים של Clever או ב-Classlink כדי להיכנס ל-Chromebook יכולים להשתמש בכניסה באמצעות חשבון Google?
כן, הוא עדיין יוכל להשתמש בכניסה באמצעות חשבון Google.
האם לכל תלמיד ותלמידה יש כתובת אימייל תקינה, גם אם אין להם גישה ל-Gmail?
לכל משתמש של Google Workspace for Education יש זהות של Google, לא משנה אם יש לו גישה ל-Gmail. זהויות מיוצגות על ידי כתובת אימייל. הזהות והגישה לכל שירות Google מסוים (כולל Gmail) הן נפרדות. כך, גם אם Gmail מושבת, התלמידים יכולים להיכנס באמצעות כתובת האימייל שלהם.
האם האדמין בבית הספר צריך לאשר מראש את האפליקציה כדי לאפשר לתלמידים להיכנס לחשבון?
מנהלי הדומיין חייבים להוסיף לרשימת ההיתרים תוסף כדי שניתן יהיה להתקין אותו. לחלופין, מנהלי דומיינים יכולים להתקין תוסף לכל המשתמשים בדומיין או ביחידה ארגונית.
משוב ושאלות כלליות
איך אפשר לשלוח בקשות להוספת תכונות או לשלוח בקשות לגבי בעיות?
תוכלו לשלוח בקשות להוספת תכונות, להציג אותן ולהצביע על בקשות קיימות באתר הציבורי למעקב אחר בעיות.
איך אפשר לדעת מתי תכונות חדשות זמינות ב-Classroom API?
עדכונים ב-API מתפרסמים בדף נתוני הגרסה, בפורום למפתחים ובכלי הציבורי למעקב אחר בעיות.
בחרתי להשתמש ב-Classroom API. איך אפשר לשאול שאלות טכניות?
אפשר לפרסם את השאלות ב-Stack Overflow באמצעות התג google-classroom.