Method: courses.students.create

사용자를 수업의 학생으로 추가합니다.

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

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

  • 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

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

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