כל מפתח יכול לשלוח בקשות ל-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 של מזהה הלקוח של OAuth ששימש לשליחת הבקשה | CREATE_ADD_ON_ATTACHMENT |
| יכולים לשנות את ההגדרות של תקופות למתן ציונים | UPDATE_GRADING_PERIOD_SETTINGS |
| יכולים ליצור, לשנות או למחוק קריטריון הערכה | CREATE_RUBRIC |
בשלב הבא, בודקים את השדה allowed בתשובה. אם הערך של allowed הוא true, למשתמש יש גישה ל-Capability שנבחר. לאחר מכן תוכלו לשלוח בקשות API שקשורות ל-Capability בשם המשתמש.