Method: courses.studentGroups.create

יוצר קבוצת תלמידים לקורס.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • ‫PERMISSION_DENIED אם למשתמש ששולח את הבקשה אין הרשאה ליצור את קבוצת התלמידים או אם יש שגיאות גישה.
  • ‫NOT_FOUND אם הקורס לא קיים או שלמשתמש ששולח את הבקשה אין גישה לקורס.
  • FAILED_PRECONDITION אם יצירת קבוצת התלמידים תחרוג מהמספר המקסימלי של קבוצות תלמידים בכל קורס.

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
courseId

string

חובה. המזהה של הקורס.

פרמטרים של שאילתה

פרמטרים
previewVersion

enum (PreviewVersion)

אופציונלי. גרסת הטרום-השקה של ה-API. ההגדרה הזו נדרשת כדי לגשת ליכולות חדשות של API שזמינות למפתחים בתוכנית ה-Preview.

גוף הבקשה

גוף הבקשה מכיל מופע של StudentGroup.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של StudentGroup.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/classroom.rosters

מידע נוסף זמין במדריך ההרשאות.