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

כל מפתח יכול לשלוח בקשות ל-Google Classroom API, אבל חלק מהתכונות של Google Classroom זמינות רק למשתמשים מסוימים. לכל תכונה יכולות להיות דרישות שונות, כמו סוג מסוים של רישיון Google Workspace for Education. פירוט מפורט של התכונות בכל רמת רישיון של Google Workspace for Education זמין בדף ההשוואה בין המהדורות.

מונח מפתח: משתמש כשיר שיש לו יכולת להשתמש בתכונה מסוימת ב-Classroom אם הוא עומד בדרישות של התכונה.

נקודת מפתח: היכולת נקבעת בנפרד לכל משתמש, והיא עשויה להשתנות עם הזמן. יכולות השימוש בתכונות מסוימות של Classroom API עשויות להיות שונות מאלה של התכונות המקבילות באפליקציית Google Classroom. לדוגמה, דרישות רישיון מסוימות חלות על יצירה, שינוי או מחיקה של קריטריונים להערכה באמצעות ה-API.

תכונות עם דרישות סף

התכונות הבאות של Classroom API זמינות רק למשתמשים שעומדים בדרישות:

• יצירה ושינוי של קבצים מצורפים של תוסף Classroom.
• שינוי ההגדרות של התקופה למתן ציונים.
• יצירה, שינוי ומחיקה של קריטריונים להערכה.

איך קובעים את היכולות של המשתמשים

בקשות ל-Classroom API נשלחות בשם משתמשים ספציפיים. לכן, לפני שליחת בקשות API עם דרישות סף, צריך לבדוק אם למשתמש יש את היכולות המתאימות.

נקודת מפתח: מומלץ לבדוק את היכולות של המשתמשים באופן יזום כדי להתאים את המראה או ההתנהגות של המוצר לתכונות של Classroom שהם יכולים לגשת אליהן.

כדי לקבוע אם למשתמש יש יכולת מסוימת, שולחים בקשת 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 בשם המשתמש.

חשוב: גם אם המשתמש עומד בדרישות, עדיין יכול להיות שבקשות API שמבוססות על העמידה בדרישות ייכשלו. המשמעות של סטטוס 'עומד בדרישות' היא שמשתמש יכול להשתמש בתכונה של Classroom, ולא שהבקשה הספציפית שלו תאושר.