Method: courses.students.create

הוספת משתמש כתלמיד בקורס.

אדמינים בדומיין יכולים להוסיף ישירות משתמשים מהדומיין שלהם כסטודנטים לקורסים בדומיין שלהם. התלמידים יכולים להוסיף את עצמם לקורס באמצעות קוד הרשמה.

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

  • PERMISSION_DENIED אם למשתמש המבקש אין הרשאה ליצור תלמידים בקורס הזה, או בגלל שגיאות גישה.
  • NOT_FOUND אם מזהה הקורס המבוקש לא קיים.
  • FAILED_PRECONDITION אם החשבון של המשתמש המבוקש מושבת, עבור שגיאות הבקשה הבאות:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS אם המשתמש כבר הוא תלמיד או מורה בקורס.

בקשת HTTP

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

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

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

פרמטרים
courseId

string

המזהה של הקורס שבו רוצים ליצור את התלמיד/ה. המזהה הזה יכול להיות המזהה שהוקצה ב-Classroom או alias.

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

פרמטרים
enrollmentCode

string

קוד ההרשמה לקורס שבו רוצים ליצור את התלמיד/ה. הקוד הזה נדרש אם השדה userId תואם למשתמש המבקש. אפשר להשמיט אותו אם למשתמש המבקש יש הרשאות אדמין ליצירת תלמידים לכל משתמש.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

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