שאלות נפוצות

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

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

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

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

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

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

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

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

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

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

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

ה-API תומך בצירוף של קבצים מ-Drive, סרטונים מ-YouTube וקישורים. עדיין אין תמיכה בצירוף של טפסים מותאמים של Google.

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