클래스룸 UI는 과제, 퀴즈 과제, 단답형 질문, 객관식 질문, 자료 등 5가지 유형의 수업 과제를 지원합니다. Classroom API는 현재 세 가지 유형을 지원하며, 이러한 유형은 API에서 CourseWorkType
라고 합니다. 과제, 단답형 질문, 객관식 질문이 여기에 해당합니다.
이 기능에 액세스하려면 특정 과정의 학생에게 할당된 과제 또는 질문을 나타내는 CourseWork 리소스를 사용하면 됩니다. 여기에는 추가 자료와 세부정보(예: 마감일 또는 최대 점수)가 포함됩니다.
CourseWork 리소스 외에도 StudentSubmission
리소스를 사용하여 완료된 과제를 관리할 수 있습니다. 다음 섹션에서는 이를 자세히 설명합니다.
과제 만들기
과제는 강의의 교사를 대신하여 만들 수 있습니다. 학생을 대신하여 강의에서 과제를 만들려고 하면 403 PERMISSION_DENIED
오류가 발생합니다. 마찬가지로 도메인 관리자도 자신이 가르치지 않는 과정의 과제를 만들 수 없으며 API를 통해 과제를 만들려고 하면 403 PERMISSION_DENIED
오류가 발생합니다.
courses.courseWork.create
메서드를 사용하여 과제를 만들 때 아래 샘플 코드와 같이 링크를 materials
로 첨부할 수 있습니다.
자바
Python
결과에는 다른 API 요청에서 할당을 참조하는 데 사용할 수 있는 서버 할당 식별자가 포함됩니다.
클래스룸 API를 통해 만든 과제에 연결된 자료를 포함하려면 리소스 연결을 사용하여 대상 URL을 지정합니다. 클래스룸에서 제목과 썸네일 이미지를 자동으로 가져옵니다. Classroom API는 Google Drive 및 YouTube 자료를 기본적으로 지원하며, DriveFile 리소스 또는 YouTubeVideo 리소스와 유사한 방식으로 포함할 수 있습니다.
기한을 지정하려면 dueDate
및 dueTime
필드를 상응하는 UTC 시간으로 설정합니다. 마감일은 미래 날짜여야 합니다.
과제 및 질문 검색
해당 과정의 학생 및 교사 또는 도메인 관리자가 과제 및 질문을 검색할 수 있습니다. 특정 과제 또는 질문을 검색하려면 courses.courseWork.get을 사용하세요. 모든 과제 또는 질문을 검색하려면 (일부 기준에 부합하는 경우) courses.courseWork.list를 사용하세요.
필요한 범위는 요청하는 사용자가 과정에 있는 역할에 따라 다릅니다. 사용자가 학생인 경우 다음 스코프 중 하나를 사용하세요.
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
사용자가 교사 또는 도메인 관리자인 경우 다음 범위 중 하나를 사용하세요.
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
과제 또는 질문을 검색할 수 있는 권한이 있다고 해서 자료 또는 자료 메타데이터에 액세스할 수 있는 권한이 있는 것은 아닙니다. 즉, 관리자가 강의의 회원이 아닌 경우 첨부된 Drive 파일의 제목이 표시되지 않을 수 있습니다. 관리자가 사용자 파일에 액세스하도록 허용하려면 도메인 전체 위임 가이드를 참고하세요.
학생 답변 관리
StudentSubmission
리소스는 과제 또는 질문에 대한 학생의 과제물과 성적을 나타냅니다. 새 질문 또는 과제가 생성될 때 각 학생에 대해 StudentSubmission
리소스가 암시적으로 생성됩니다.
다음 섹션에서는 학생 응답을 관리하는 일반적인 작업을 설명합니다.
학생 답변 검색
학생은 자신의 제출물을 검색할 수 있고, 교사는 수업의 모든 학생의 제출물을 검색할 수 있으며, 도메인 관리자는 도메인의 모든 학생의 모든 제출물을 검색할 수 있습니다. 각 학생 제출물에는 식별자가 할당됩니다. 식별자를 알고 있다면 courses.courseWork.studentSubmissions.get
를 사용하여 식별자를 가져옵니다.
다음 샘플과 같이 courses.courseWork.studentSubmissions.list
메서드를 사용하여 일부 기준과 일치하는 StudentSubmission
리소스를 가져옵니다.
자바
Python
다음 샘플과 같이 userId
매개변수를 지정하여 특정 학생에게 속한 StudentSubmission
리소스를 가져옵니다.
자바
Python
학생은 Google Admin SDK에서 반환한 사용자의 고유 ID 또는 이메일 주소로 식별됩니다. 현재 사용자는 "me"
약어를 사용하여 자신의 ID를 참조할 수도 있습니다.
과정 내 모든 과제에 대한 학생 제출물을 가져올 수도 있습니다. 이렇게 하려면 다음 샘플과 같이 리터럴 "-"
를 courseWorkId
로 사용합니다.
자바
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
필요한 범위는 요청하는 사용자가 과정에 있는 역할에 따라 다릅니다. 사용자가 교사 또는 도메인 관리자인 경우 다음 범위를 사용하세요.
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
사용자가 학생인 경우 다음 범위를 사용하세요.
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
학생 제출물을 검색할 수 있는 권한이 있다고 해서 첨부파일 또는 첨부파일 메타데이터에 액세스할 수 있는 권한이 있는 것은 아닙니다. 실제로는 관리자가 강의 멤버가 아닌 경우 첨부된 Drive 파일의 제목이 표시되지 않을 수 있습니다. 관리자가 사용자 파일에 액세스하도록 허용하려면 도메인 전체 위임 가이드를 참고하세요.
학생 답변에 첨부파일 추가하기
Link
, DriveFile
또는 YouTubeVideo
리소스를 첨부하여 학생 제출물에 링크를 첨부할 수 있습니다. 다음 샘플과 같이 courses.courseWork.studentSubmissions.modifyAttachments
를 사용하여 이 작업을 실행합니다.
자바
Python
링크 첨부파일은 대상 URL로 정의됩니다. 클래스룸에서 제목과 썸네일 이미지를 자동으로 가져옵니다. 다른 자료에 대한 자세한 내용은 각 참조 페이지에서 확인하실 수 있습니다.
StudentSubmission
는 과정 교사 또는 소유한 학생만 수정할 수 있습니다. 학생 제출물의 CourseWorkType
이 ASSIGNMENT
인 경우에만 Materials
를 첨부할 수 있습니다.
필요한 범위는 요청하는 사용자가 과정에 있는 역할에 따라 다릅니다. 사용자가 교사인 경우 다음 범위를 사용하세요.
https://www.googleapis.com/auth/classroom.coursework.students
사용자가 학생인 경우 다음 범위를 사용하세요.
https://www.googleapis.com/auth/classroom.coursework.me