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