На этой странице перечислены некоторые распространенные недоразумения и крайние случаи, которые вы, возможно, захотите принять во внимание при разработке и внедрении дополнения для Класса. Вам рекомендуется реализовать отказоустойчивость и тесты, охватывающие эти случаи.
Концепции Google Класса
В этом разделе освещаются крайние случаи и концепции, относящиеся к надстройкам, применимым ко всему Google Classroom.
Курсы и роли пользователей
Курс — это центральная организационная единица, которая связывает преподавателей и студентов. Курсы — это высший уровень организации в API Google Classroom.
Отдельные пользователи могут быть добавлены к курсу в качестве «преподавателей» или «студентов». Роль пользователя в курсе не привязана к его роли в учреждении . Это означает, что учащийся школы может быть преподавателем курса, а преподаватели могут быть студентами курса. Хотя чаще всего курс представляет собой регулярный учебный предмет, курсы также создаются для организации студенческих клубов или проведения профессионального развития.
Следующее применимо ко всем курсам в Google Classroom.
По поводу преподавателей курсов :
- На курсе может быть несколько преподавателей.
- Учителей можно добавить к курсу в любое время.
- Учителя могут быть отстранены от курса в любое время.
Элемент потока
Элементы потока — это фрагменты опубликованного контента, которыми поделились участники курса. Разработчики и преподаватели могут создавать дополнительные вложения для трех типов элементов потока: объявлений, заданий и материалов.
Учителя создают объявления в верхней части страницы потока в пользовательском интерфейсе Класса. Учителя создают задания и материалы, нажимая кнопку «Создать» на вкладке «Задания». Разработчики могут создавать их программно с помощью Classroom API.
Задание — это элемент потока, который может принимать материалы, отправленные учащимися. Задания — это единственный тип элементов потока, отображаемых в журнале оценок, которые могут содержать дополнительные вложения.
Что касается элементов потока :
- Задание или материал могут быть назначены определенной группе студентов курса.
- Задание может быть оцененным и неоцененным. Преподаватели могут изменить статус оценки задания в любое время.
- Задание может иметь несколько вложений.
- Задание может иметь вложения разных типов. Например, одно задание может одновременно содержать Документы Google, видео YouTube и дополнительные вложения.
- Задание может содержать дополнительные вложения от нескольких разработчиков.
- Разработчики могут получать и изменять информацию о любом элементе потока с помощью одного из своих дополнительных вложений.
- Разработчики могут сдать, вернуть или вернуть материалы, отправленные учащимися для задания, которое включает в себя одно из их дополнительных вложений.
- Разработчики могут устанавливать оценки только для отдельных работ учащихся в созданных ими заданиях.
Скопированные элементы потока
Преподаватели могут скопировать элемент потока, скопировав курс, повторно используя задание или опубликовав элемент потока в нескольких курсах. Прочтите наше руководство по скопированному контенту , чтобы понять, как надстройка может справиться с этими сценариями.
Учреждение пользователя
API Google Classroom не возвращает идентификаторы учебного заведения, здания или любого другого членства пользователя выше уровня курса.