זכאות המשתמשים

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