כל מפתח יכול לשלוח בקשות ל-Google Classroom API, אבל חלק מהתכונות של Google Classroom זמינות רק למשתמשים מסוימים. לכל תכונה יכולות להיות דרישות שונות, כמו סוג מסוים של רישיון Google Workspace for Education. פירוט מפורט של התכונות בכל רמת רישיון של Google Workspace for Education זמין בדף ההשוואה בין המהדורות.
תכונות עם דרישות סף
התכונות הבאות של Classroom API זמינות רק למשתמשים שעומדים בדרישות:
- יצירת קבצים מצורפים לתוספים ל-Classroom
- שינוי ההגדרות של תקופות למתן ציונים
- יצירה, עדכון ומחיקה של קריטריונים להערכה
איך קובעים את היכולות של המשתמשים
הבקשות ל-Classroom API נשלחות בשם משתמשים ספציפיים. לכן, לפני שליחת בקשות API עם דרישות סף, צריך לבדוק אם למשתמש יש את היכולות המתאימות.
כדי לקבוע אם למשתמש יש יכולת מסוימת, שולחים בקשת API ל-method checkUserCapability. כוללים את הסוג המתאים של Capability לתכונת Classroom שבה רוצים להשתמש. מציינים את הערך המתאים של Capability לכל תכונה:
| כדי לבדוק אם המשתמש… | Capability |
|---|---|
| יש לו גישה לתוסף של Classroom שבבעלות הפרויקט ב-Google Cloud שמבצע את הבקשה | CREATE_ADD_ON_ATTACHMENT |
| שינוי ההגדרות של תקופות למתן ציונים | UPDATE_GRADING_PERIOD_SETTINGS |
| ליצור או לשנות קריטריונים | CREATE_RUBRIC |
בשלב הבא, בודקים את השדה allowed בתגובה. אם הערך של allowed הוא true, למשתמש יש גישה ל-Capability שנבחר. לאחר מכן תוכלו לשלוח בקשות API שקשורות ל-Capability מטעם המשתמש.