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