이 페이지에는 클래스룸 부가기능을 설계하고 구현할 때 고려해야 할 몇 가지 일반적인 오해와 특이 사례가 나열되어 있습니다. 이러한 사례를 다루는 페일세이프 및 테스트를 구현하는 것이 좋습니다.
Google 클래스룸 개념
이 섹션에서는 모든 Google 클래스룸에 적용되는 부가기능과 관련된 예외 사례와 개념을 중점적으로 설명합니다.
과정 및 사용자 역할
과정은 교사와 학생을 연결하는 중앙 조직 단위입니다. 과정은 Google 클래스룸 API에서 가장 높은 수준의 조직입니다.
개별 사용자는 '교사' 또는 '학생'으로 과정에 추가될 수 있습니다. 사용자의 과정 내 역할은 기관 내 역할과 연결되지 않습니다. 즉, 학교의 학생은 수업에서 교사가 될 수 있고 교사 구성원은 수업을 듣는 학생일 수 있습니다. 교육과정이 정기적으로 예정된 학술 과목을 나타내는 경우가 가장 흔하지만, 학생 클럽을 조직하거나 전문성 개발을 수행하기 위해 과정도 개설됩니다.
다음 내용은 Google 클래스룸 내의 모든 과정에 적용됩니다.
강의 교사 관련 정보:
- 과정에는 교사가 두 명 이상 있을 수 있습니다.
- 교사는 언제든지 과정에 추가될 수 있습니다.
- 교사는 언제든지 강의에서 삭제될 수 있습니다.
스트림 항목
스트림 항목은 학습 프로그램의 회원과 공유하는 게시된 콘텐츠입니다. 개발자와 교사는 공지사항, 과제, 자료라는 세 가지 스트림 항목 유형에 부가기능 첨부파일을 만들 수 있습니다.
교사는 클래스룸 UI의 스트림 페이지 상단에서 공지사항을 만듭니다. 교사는 수업 과제 탭에서 만들기 버튼을 클릭하여 과제와 자료를 만들 수 있습니다. 개발자는 Classroom API를 통해 프로그래매틱 방식으로 이를 만들 수 있습니다.
과제는 학생 제출물을 수락할 수 있는 스트림 항목입니다. 과제는 성적 기록에 부가기능 첨부파일이 포함될 수 있는 유일한 스트림 항목 유형입니다.
스트림 항목에 관한 정보는 다음과 같습니다.
- 과제 또는 자료는 과정의 일부 학생에게 할당될 수 있습니다.
- 과제는 채점되거나 채점되지 않을 수 있습니다. 교사는 언제든지 과제의 채점 상태를 변경할 수 있습니다.
- 과제에는 첨부파일이 두 개 이상 있을 수 있습니다.
- 과제에는 다양한 유형의 첨부파일이 있을 수 있습니다. 예를 들어 한 과제에 Google Docs, YouTube 동영상, 부가기능 첨부파일이 동시에 있을 수 있습니다.
- 과제에는 두 명 이상의 개발자가 만든 부가기능 첨부파일이 있을 수 있습니다.
- 개발자는 부가기능 첨부파일 중 하나를 사용하여 스트림 항목에 대한 정보를 가져오고 수정할 수 있습니다.
- 개발자는 부가기능 첨부파일 중 하나가 포함된 과제에 대해 학생 제출물을 제출, 복원 또는 반환할 수 있습니다.
- 개발자는 자신이 만든 과제의 개별 학생 제출물의 성적만 설정할 수 있습니다.
스트림 항목 복사됨
교사는 강의를 복사하거나, 과제를 재사용하거나, 스트림 항목을 여러 강의에 게시하여 스트림 항목을 복사할 수 있습니다. 부가기능이 이러한 시나리오를 처리하는 방법을 알아보려면 복사된 콘텐츠 가이드를 참고하세요.
사용자의 기관
Google 클래스룸 API는 사용자의 기관, 건물 또는 과정 수준 이상의 기타 멤버십의 식별자를 반환하지 않습니다.