개발자는 Google Classroom 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 클래스룸 강의에서 강의 자료를 만들 수 있는 것이 아니라 승인된 사용자가 가르치는 강의에서만 강의 자료를 만들 수 있습니다.
- 사용자가 콘텐츠를 수신할 과정을 선택할 수 있는 방법이 필요합니다.
courses.list를 사용하여 사용자가 가르치는 과정의 목록을 가져온 다음 사용자가 목록에서 하나 이상의 과정을 선택할 수 있도록 허용합니다. - 사용자가 클래스룸에서
link Material를 클릭하면 새 탭에서 링크가 열립니다. URL이 열리면 서버는 클래스룸에서 정보를 수신하지 않습니다. - 교사는 개발자와 별개로 강의 과정을 수정하거나 삭제할 수 있습니다. 즉, 학습 과정에 대한 개발자의 지식은 그렇지 않을 수 있습니다. 과정 변경사항을 확인해야 하는 경우 과정 변경에 대한 푸시 알림을 설정해 보세요.
- 교사는 웹사이트의 URL 링크를 클래스룸 UI에 붙여넣어 교과 과정을 만들 수 있습니다. 이러한 방식으로 만든 수업 과제는 전적으로 선생님이 소유하므로 Classroom API를 사용하여 성적을 보거나 수정하거나 제출할 수 없습니다.