Method: courses.studentGroups.delete

מחיקת קבוצת תלמידים.

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

  • PERMISSION_DENIED אם למשתמש ששולח את הבקשה אין הרשאה למחוק את קבוצת התלמידים המבוקשת, או אם יש שגיאות גישה.
  • NOT_FOUND אם קבוצת התלמידים לא קיימת או שלמשתמש אין גישה לקבוצת התלמידים.

בקשת HTTP

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

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

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

פרמטרים
courseId

string

חובה. המזהה של הקורס שמכיל את קבוצת התלמידים שרוצים למחוק.

id

string

חובה. המזהה של קבוצת התלמידים שרוצים למחוק.

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.

היקפי הרשאות

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

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

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