משתמש מבקש יכול לבדוק את היכולות רק עבור עצמו.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED
אם למשתמש המבקש אין הרשאה לבדוק את הזכאות של המשתמש שצוין.INVALID_ARGUMENT
אם הבקשה לא תקינה.
בקשת HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
userId |
חובה. המזהה של המשתמש. כשמציינים את המזהה הזה כפרמטר של בקשה, הוא יכול להיות אחד מהערכים הבאים:
|
פרמטרים של שאילתה
פרמטרים | |
---|---|
capability |
חובה. היכולת שצריך לבדוק עבור המשתמש הזה. לדוגמה, כדי לבדוק אם משתמש יכול ליצור קובץ מצורף של תוסף, צריך להגדיר את הערך |
previewVersion |
זה שינוי אופציונלי. גרסת ה-Preview של ה-API. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה מהבדיקה של יכולות המשתמש.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{
"capability": enum ( |
שדות | |
---|---|
capability |
היכולת של Classroom. |
allowed |
האם המשתמש מורשה להשתמש ביכולת שצוינה. |
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
מידע נוסף זמין במדריך ההרשאות.
פונקציה
טיפוסים בני מנייה (enum) שמייצג את היכולת.
טיפוסים בני מנייה (enum) | |
---|---|
CAPABILITY_UNSPECIFIED |
לא נתמכת. |
CREATE_ADD_ON_ATTACHMENT |
היכולת ליצור ולשנות קבצים מסוג AddOnAttachments שמשויכים לפרויקט ב-Developer Console של מזהה הלקוח ב-OAuth ששימש לשליחת הבקשה. |
UPDATE_GRADING_PERIOD_SETTINGS |
יכולת לשנות את ההגדרות של תקופת המטלות. |