השיטה הזו מחזירה את קודי השגיאה הבאים:
-
PERMISSION_DENIEDאם למשתמש ששולח את הבקשה אין הרשאה ליצור את קבוצת התלמידים או אם יש שגיאות גישה. -
NOT_FOUNDאם הקורס לא קיים או שלמשתמש ששולח את הבקשה אין גישה לקורס. FAILED_PRECONDITIONאם יצירת קבוצת התלמידים תחרוג מהמספר המקסימלי של קבוצות תלמידים בכל קורס.
בקשת HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
courseId |
חובה. המזהה של הקורס. |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
previewVersion |
אופציונלי. גרסת הטרום-השקה של ה-API. ההגדרה הזו נדרשת כדי לגשת ליכולות חדשות של API שזמינות למפתחים בתוכנית ה-Preview. |
גוף הבקשה
גוף הבקשה מכיל מופע של StudentGroup.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של StudentGroup.
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/classroom.rosters
מידע נוסף זמין במדריך ההרשאות.