사용자를 수업의 학생으로 추가합니다.
도메인 관리자는 도메인 내 사용자를 강의에 학생으로 직접 추가할 수 있습니다. 학생은 등록 코드를 사용하여 강의에 자신을 추가할 수 있습니다.
이 메서드는 다음 오류 코드를 반환합니다.
PERMISSION_DENIED
을 요청한 사용자가 이 강의에서 학생을 만들 수 없거나 액세스 오류로 인해 학생을 만들 수 없는 경우PERMISSION_DENIED
입니다.NOT_FOUND
: 요청된 과정 ID가 존재하지 않는 경우FAILED_PRECONDITION
: 다음과 같은 요청 오류로 인해 요청된 사용자 계정이 사용 중지된 경우:- CourseMemberLimitReached
- CourseNotModifiable
- UserGroupsMembershipLimitReached
- InactiveCourseOwner
ALREADY_EXISTS
사용자가 이미 수업의 학생 또는 교사인 경우
HTTP 요청
POST https://classroom.googleapis.com/v1/courses/{courseId}/students
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
courseId |
학생을 생성할 과목의 식별자입니다. 이 식별자는 클래스룸에서 할당한 식별자 또는 |
쿼리 매개변수
매개변수 | |
---|---|
enrollmentCode |
학생을 만들 과정의 등록 코드입니다. 이 코드는 |
요청 본문
요청 본문에는 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
자세한 내용은 승인 가이드를 참고하세요.