שאלות נפוצות

הצגה, יצירה ושינוי של עבודות בקורס ב-Classroom

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

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

  • הצגת מטלות ושאלות (שנקראות ביחד CourseWork) של משתמש.
  • יצירה, שינוי ומחיקה של CourseWork.
  • צירוף חומרי לימוד (קבצים מ-Drive, סרטונים מ-YouTube, קישורים) אל CourseWork.
  • שינוי מצב ההגשה של תלמיד (למשל, הגשה, החזרה, ביטול הגשה).
  • הגדרת הציון להגשת מטלה.
  • לצרף חומרי לימוד (קבצים מ-Drive, סרטונים מ-YouTube, קישורים) לעבודות של תלמידים.

כמה תרחישים לדוגמה לשימוש ב-CourseWork:

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

אילו הרשאות נדרשות לאפליקציה שלי כדי ליצור או לשנות מטלות?

בדרך כלל, אפליקציה יכולה לשנות רק עבודה שהיא יוצרת. במילים אחרות, כל בקשות ה-API לשינוי CourseWork צריכות להשתמש באותו מזהה פרויקט ב-Google Cloud ששימש ליצירת CourseWork.

תוספים ל-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 Workspace Marketplace לפרויקט אחד ב-Google Cloud?

לא. אי אפשר ליצור שני כרטיסי מוצר ב-Google Workspace Marketplace לפרויקט יחיד ב-Google Cloud.

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

האם אפשר לעשות שימוש חוזר בלקוח OAuth מפרויקט אחר ב-Google Cloud עם פרויקט ב-Google Cloud לתוספים ל-Classroom?

לא, לקוח OAuth מפרויקט ב-Google Cloud שאינו פרויקט התוסף של Classroom ב-Google Cloud לא יכול לפעול. ממשק Classroom API דוחה טוקנים לגישה שנוצרו על ידי פרויקט אחר ב-Google Cloud. צריך ליצור לקוח OAuth נפרד לפרויקט של התוסף.

חוויית משתמש

הלוגו שלנו לא מתאים לריבוע קטן. אילו אפשרויות גודל יש ללוגו בסרגל הכותרת של ה-iframe של תוספים ל-Classroom?

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

דומיינים

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

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

איך מנהלי דומיין משתמשים בתוספים?

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

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

API

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

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

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

ה-iframe של כלי בדיקת העבודות של התלמידים מסופק רק עבור קבצים מצורפים מסוג פעילות. כדי לדעת אם סוג הפוסט תומך בעבודות של תלמידים, צריך להתקשר אל השיטה 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 עם כתובת האימייל שלהם. הזהויות מיוצגות על ידי מזהה משתמש וכתובת אימייל. משתמש ב-Google Workspace for Education יכול לשנות את כתובת האימייל שלו, ולכן מומלץ להשתמש במזהי משתמש כמפתחות ראשיים כשמאחסנים פרטי משתמש.

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

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

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

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

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

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

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

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

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