Method: courses.studentGroups.studentGroupMembers.create

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

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

  • ‫PERMISSION_DENIED אם למשתמש ששולח את הבקשה אין הרשאה ליצור את קבוצת התלמידים או את החבר בקבוצה, שגיאות גישה.
  • ‫NOT_FOUND אם קבוצת התלמידים לא קיימת או שלמשתמש אין גישה לקבוצת התלמידים.
  • ALREADY_EXISTS אם התלמיד או התלמידה כבר חברים בקבוצה.
  • FAILED_PRECONDITION אם מנסים להוסיף חבר לקבוצת סטודנטים שהגיעה למגבלת החברים.

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

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

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

פרמטרים
previewVersion

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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