שאלות נפוצות

הצגה, יצירה ושינוי של CourseWork ב-Classroom

מה אפשר ליצור באמצעות נקודות הקצה של CourseWork ב-Classroom API?

נקודות הקצה (endpoints) מאפשרות למפתחים להציג ולנהל את העבודות בכיתה. באופן ספציפי, אפשר לבצע את כל הפעולות הבאות:

  • הצגת מטלות ושאלות (שנקראות ביחד 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.