כל מפתח יכול לשלוח בקשות ל-Google Classroom API, אבל חלק מהתכונות של Google Classroom זמינות רק למשתמשים מסוימים. לכל תכונה יכולות להיות דרישות שונות, כמו סוג מסוים של רישיון Google Workspace for Education.
בדף ההשוואה בין המהדורות תוכלו למצוא פירוט של התכונות בכל רמת רישיון של Google Workspace for Education.
תכונות עם דרישות סף
התכונות הבאות של Classroom API זמינות רק למשתמשים שעומדים בדרישות:
הבקשות ל-Classroom API נשלחות בשם משתמשים ספציפיים.
לכן, לפני שליחת בקשות API עם דרישות סף, כדאי לבדוק אם למשתמש יש את היכולות המתאימות.
כדי לקבוע אם למשתמש יש יכולת מסוימת, שולחים בקשת API ל-method checkUserCapability. כוללים את הסוג המתאים של Capability לתכונת Classroom שבה רוצים להשתמש. מציינים את הערך המתאים של Capability לכל תכונה:
כדי לבדוק אם המשתמש…
Capability
יכול ליצור או לשנות קובץ מצורף של תוסף Classroom שמשויך לפרויקט ב-Google Cloud של מזהה הלקוח של OAuth ששימש לשליחת הבקשה
בשלב הבא, בודקים את השדה allowed בתשובה. אם הערך של allowed הוא true, למשתמש יש גישה ל-Capability שנבחר. לאחר מכן תוכלו לשלוח בקשות API שקשורות ל-Capability בשם המשתמש.
[null,null,["עדכון אחרון: 2025-01-14 (שעון UTC)."],[[["Certain Google Classroom features, like add-on attachments, grading periods, and rubrics, are only accessible to eligible users with specific Google Workspace for Education licenses."],["User capabilities for these features are determined individually and can vary, requiring developers to verify access before making related API requests."],["Developers can use the `checkUserCapability` method to determine if a user has the necessary permissions for specific Classroom API features, ensuring tailored product behavior."],["Even with eligibility confirmed, individual API requests might still fail due to other factors, emphasizing that eligibility doesn't guarantee success."]]],[]]
