Method: courses.students.create

사용자를 과정의 학생으로 추가합니다.

도메인 관리자는 도메인 내 사용자를 도메인 내 강의에 학생으로 직접 추가할 수 있습니다. 학생은 등록 코드를 사용하여 자신을 과정에 추가할 수 있습니다.

이 메서드는 다음 오류 코드를 반환합니다.

  • 요청하는 사용자가 이 과정에 학생을 만들 권한이 없거나 액세스 오류인 경우 PERMISSION_DENIED입니다.
  • 요청된 과정 ID가 없는 경우 NOT_FOUND입니다.
  • FAILED_PRECONDITION 요청된 사용자의 계정이 사용 중지된 경우 다음 요청 오류:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • 사용자가 이미 과정의 학생 또는 교사인 경우 ALREADY_EXISTS입니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
courseId

string

학생을 만들 코스의 식별자입니다. 이 식별자는 클래스룸에서 할당한 식별자 또는 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

자세한 내용은 승인 가이드를 참고하세요.