개발자는 Google 클래스룸 API를 사용하여 Google 클래스룸의 수업과 상호작용할 수 있습니다. 이 방식으로 API를 사용하는 애플리케이션을 CourseWork 통합이라고 합니다.
이 통합 경로는 일반적으로 클래스룸 외부 리소스 링크를 사용하여 과제를 만들고 채점하는 데 사용됩니다. 클래스룸 공유 버튼에 비해 과제 관리 기능에 대한 개발자 액세스 권한이 더 많이 제공됩니다.
작동 방식
CourseWork 통합의 핵심 기능은 Classroom API를 사용하여 과제, 공지사항, 수업 자료를 만들고 관리하는 것입니다.
CourseWork 통합으로 지원되는 일반적인 사용자 여정의 한 예는 교사가 웹사이트 또는 애플리케이션 내에서 콘텐츠를 검색하고, 할당하고, 평가할 수 있도록 하는 것입니다.
- 교사 사용자가 웹사이트에 로그인합니다.
- 교사가 수업에서 공유할 콘텐츠를 찾거나 만듭니다. 교사가 웹사이트의 버튼을 클릭하여 이 콘텐츠를 Google 클래스룸으로 보냅니다.
- 애플리케이션이
courses.courseWork.create에 요청을 발행합니다. 요청의 본문에는 다음이 포함된CourseWork객체가 포함됩니다.- 대상 과정 ID입니다.
- 과제의 제목입니다.
- 과제의 텍스트 설명입니다.
- 교사가 선택한 콘텐츠의 URL이 포함된
linkMaterial - 선택한 콘텐츠에서 획득할 수 있는 최대 점수입니다(선택사항).
- 클래스룸에 링크 첨부파일이 포함된 새 과제가 표시됩니다.
링크는
create요청에 지정된 URL을 참조합니다. 예는 그림 1을 참고하세요. - 과제에 대한 새 열도 클래스룸 성적장에 표시되며, 제공된 경우 최대 점수도 표시됩니다.
- 학생은 과제를 받고
link Material를 클릭하여 제공된 URL을 새 탭에서 열고 웹사이트의 콘텐츠를 보거나 완료합니다. 선택적으로 학생이 과제를 제출할 수 있는 컨트롤을 제공합니다. - 선택적으로
courses.courseWork.studentSubmissions.modifyAttachments에 요청을 발행하여 학생 제출물에 첨부파일을 추가합니다(예: Google Drive 파일 또는 웹사이트에서 학생의 작업을 가리키는link Material). - 원하는 경우
courses.courseWork.studentSubmissions.patch에 요청을 발행하여 과제에 대한 학생의 성적을 설정합니다.
그림 1. CourseWork 통합으로 생성된 link Material로 과제를 수정할 때의 교사 보기
또는 courses.announcements.create 또는 courses.courseWorkMaterials.create를 호출하여 과제 대신 공지사항이나 수업 자료를 만들 수 있습니다. 관련 Classroom API 작업에 관한 자세한 설명은 수업 만들기 및 관리 및 성적 설정 및 업데이트 페이지를 참고하세요.
고려사항
CourseWork 통합이 제품 요구사항에 적합한 선택인지 결정하기 전에 다음 사항을 고려하세요.
- 사용자를 승인하고 동의를 요청해야 합니다. 사용자를 대신하여 API 요청을 하고 있습니다. 즉, 예를 들어 모든 Google Classroom 강의에서 과제를 만들 수 없습니다. 승인된 사용자가 가르치는 강의에서만 과제를 만들 수 있습니다.
- 사용자가 콘텐츠를 수신할 강의를 선택할 수 있는 방법이 필요합니다.
courses.list를 사용하여 사용자가 가르치는 과정 목록을 가져온 다음 사용자가 목록에서 하나 이상의 과정을 선택하도록 허용합니다. - 사용자가 클래스룸에서
link Material를 클릭하면 새 탭에서 링크가 열립니다. URL이 열리면 서버에서 클래스룸의 정보를 수신하지 않습니다. - 교사는 개발자와 독립적으로 학습 자료를 수정하거나 삭제할 수 있습니다. 즉, 개발자의 학습 과정에 대한 지식이 오래될 수 있습니다. 수업 변경사항을 알아야 하는 경우 수업 변경사항에 대한 푸시 알림을 설정하는 것이 좋습니다.
- 교사는 웹사이트의 URL에 대한 링크를 붙여넣어 클래스룸 UI에서 학습 자료를 만들 수 있습니다. 이러한 방식으로 생성된 과제는 교사만 소유하므로 Classroom API를 사용하여 제출 성적을 보거나 수정하거나 설정할 수 없습니다.