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