CourseWork 통합

개발자는 Google Classroom API를 사용하여 Google 클래스룸의 과정과 상호작용할 수 있습니다. 이러한 방식으로 API를 사용하는 애플리케이션을 CourseWork 통합이라고 합니다.

이 통합 경로는 일반적으로 클래스룸 외부의 리소스에 대한 링크가 있는 과제를 만들고 채점하는 데 사용됩니다. 클래스룸 공유 버튼에 비해 개발자가 과정 관리에 액세스할 수 있는 권한이 더 많습니다.

작동 방식

CourseWork 통합의 핵심 기능은 Classroom API를 사용하여 과제, 공지사항, 과정 자료를 만들고 관리하는 것입니다.

CourseWork 통합으로 사용 설정되는 일반적인 사용자 여정의 한 가지 예는 교사가 웹사이트 또는 애플리케이션 내에서 콘텐츠를 찾고, 할당하고, 채점할 수 있도록 하는 것입니다.

  1. 교사 사용자가 웹사이트에 로그인합니다.
  2. 교사는 수업과 공유할 콘텐츠를 찾거나 만듭니다. 교사는 웹사이트의 버튼을 클릭하여 이 콘텐츠를 Google 클래스룸으로 전송합니다.
  3. 애플리케이션이 courses.courseWork.create에 요청을 보냅니다. 요청 본문에는 다음을 포함하는 CourseWork 객체가 포함됩니다.
    • 대상 과정 ID입니다.
    • 과제의 제목입니다.
    • 과제에 대한 텍스트 설명입니다.
    • 교사가 선택한 콘텐츠의 URL이 포함된 link Material입니다.
    • 선택한 콘텐츠에서 얻을 수 있는 최대 점수(선택사항)입니다.
  4. 클래스룸에 링크 첨부파일이 포함된 새 과제가 표시됩니다. 이 링크는 create 요청에 지정된 URL을 참조합니다. 예는 그림 1을 참고하세요.
  5. 제공된 경우 최대 점수를 포함하여 과제의 새 열이 클래스룸 성적표에도 표시됩니다.
  6. 학생이 과제를 받고 link Material 아이콘을 클릭하여 새 탭에서 제공된 URL을 열고 웹사이트의 콘텐츠를 보거나 완료합니다. 원하는 경우 학생이 과제를 제출할 수 있는 컨트롤을 제공합니다.
  7. 원하는 경우 courses.courseWork.studentSubmissions.modifyAttachments에 요청하여 학생 제출물에 첨부파일(예: Google Drive 파일 또는 웹사이트에서 학생의 작업을 가리키는 link Material)을 추가할 수 있습니다.
  8. 원하는 경우 courses.courseWork.studentSubmissions.patch에 요청하여 과제에 대한 학생의 성적을 설정합니다.

링크 자료 첨부파일이 있는 CourseWork 과제 수정

그림 1. CourseWork 통합으로 생성된 link Material을 사용하여 과제를 수정할 때의 교사 보기

또는 courses.announcements.create 또는 courses.courseWorkMaterials.create를 호출하여 과제 대신 공지사항이나 과정 자료를 만들 수 있습니다. 관련 Classroom API 작업에 관한 자세한 설명은 강의 과정 만들기 및 관리 및 성적 설정 및 업데이트 페이지를 참고하세요.

고려사항

CourseWork 통합이 제품 요구사항에 적합한지 결정하기 전에 다음 사항을 고려하세요.

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