כל מפתח יכול לשלוח בקשות ל-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 בשם המשתמש.