שאלות נפוצות

הצגה, יצירה ושינוי של עבודות ב-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 יכולים להיות שני כרטיסי מוצר ב-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. הבחירה הזו נעשתה כדי להתאים את הצורה של סמל האתר לזו של הסמלים ששימוש בהם חברות באתרים שלהן. אנחנו ממליצים להשתמש באותו לוגו במרחב המשותף כדי לשמור על עקביות המותג.

דומיינים

האם לכל המורים והתלמידים באותו דומיין יש גישה לתוסף שהותקן?

לאדמינים ברמת בית הספר יש אפשרות לקבוע אילו מורים יוכלו לראות תוסף שהותקן. רק משתמשים עם רישיון Teaching & Learning או רישיון Education Plus יכולים להשתמש בתוספים של Classroom.

איך מנהלי הדומיינים מקיימים אינטראקציה עם התוספים?

אדמינים בדומיין קובעים מי יוכל להשתמש בתוסף. הם יכולים להתקין תוסף לדומיין שלם באמצעות אפשרות ההתקנה של האדמין. אם אפשר להתקין את התוסף בנפרד, חשוב לזכור שרוב האדמינים שומרים רשימת היתרים של תוספים. מורים יכולים להתקין בעצמם תוספים שנמצאים ברשימה הזו. האדמין יכול גם להתקין את התוסף בנפרד לצורך בדיקה.

יכול להיות שמנהלי החשבון ירצו גם לראות את נתוני השימוש של התוסף. אם המוצר שלכם תומך בכך, כדאי לספק נתונים סטטיסטיים על השימוש בתוסף בתצוגת אדמין באתר שלכם.

API

איך אפשר לדעת בצורה מהימנה אם דף השותף נטען בתוך iframe או בכרטיסייה קופצת?

אין כרגע שיטה להבדיל בין השניים.

אילו פריטים של עבודות שניתן להקצות מקבלים iframe של בדיקת עבודות של תלמידים?

ה-iframe של 'בדיקת עבודות של תלמידים' זמין רק לקבצים מצורפים מסוג 'פעילות'. קוראים לmethod‏ courses.courseWork.getAddOnContext כדי לבדוק אם סוג הפוסט תומך בעבודות של תלמידים. השדה supportsStudentWork יכול להיות true רק לסוג פוסט שהוא פעילות.

האם לקובץ מצורף של תוסף יש גישה לפריט הסטרימינג שאליו הוא מצורף?

כן. אפשר get או patch כל Announcement,‏ CourseWork או CourseWorkMaterial שמכיל לפחות אחד מהקבצים המצורפים של התוספים. אפשר reclaim, return או turnIn CourseWork StudentSubmission.

כניסה יחידה (SSO)

כן, הם עדיין יכולים להשתמש בכניסה באמצעות חשבון Google.

האם לכל התלמידים יש כתובת אימייל תקינה, גם אם אין להם גישה ל-Gmail?

לכל משתמש ב-Google Workspace for Education יש זהות ב-Google, גם אם אין לו גישה ל-Gmail. הזהויות מיוצגות על ידי כתובת אימייל. הזהות והגישה לכל שירות Google מסוים (כולל Gmail) הם דברים נפרדים. לכן, גם אם Gmail מושבת, תלמידים יכולים להיכנס באמצעות כתובת האימייל שלהם.

האם האדמין של בית הספר צריך לאשר מראש את האפליקציה כדי לאפשר לתלמידים להיכנס לחשבון?

כדי להתקין תוסף, מנהלי הדומיין צריכים להוסיף אותו לרשימת ההיתרים. אדמינים בדומיין יכולים להתקין תוסף לכל המשתמשים בדומיין או ביחידה ארגונית.

משוב ושאלות כלליות

איך שולחים בקשות להוספת תכונות או מדווחים על בעיות?

אתם יכולים לשלוח בקשות לתכונות, להציג אותן ולהצביע עליהן באתר הציבורי למעקב אחר בעיות.

איך אפשר לדעת מתי תכונות חדשות זמינות ב-Classroom API?

עדכונים ל-API מתפרסמים בדף הערות המוצר, בפורום למפתחים ובכלי למעקב אחר בעיות ציבוריות.

אני משתמש ב-Classroom API. איך אפשר לשאול שאלות טכניות?

אתם יכולים לפרסם את השאלות שלכם ב-Stack Overflow עם התג google-classroom.