Ключевые соображения

На этой странице перечислены некоторые распространенные недоразумения и крайние случаи, которые вы, возможно, захотите принять во внимание при разработке и внедрении дополнения для Класса. Вам рекомендуется реализовать отказоустойчивость и тесты, охватывающие эти случаи.

Концепции Google Класса

В этом разделе освещаются крайние случаи и концепции, относящиеся к надстройкам, применимым ко всему Google Classroom.

Курсы и роли пользователей

Курс — это центральная организационная единица, которая связывает преподавателей и студентов. Курсы — это высший уровень организации в API Google Classroom.

Отдельные пользователи могут быть добавлены к курсу в качестве «преподавателей» или «студентов». Роль пользователя в курсе не привязана к его роли в учреждении . Это означает, что учащийся школы может быть преподавателем курса, а преподаватели могут быть студентами курса. Хотя чаще всего курс представляет собой регулярный учебный предмет, курсы также создаются для организации студенческих клубов или проведения профессионального развития.

Следующее применимо ко всем курсам в Google Classroom.

По поводу преподавателей курсов :

  • На курсе может быть несколько преподавателей.
  • Учителей можно добавить к курсу в любое время.
  • Учителя могут быть отстранены от курса в любое время.

Элемент потока

Элементы потока — это фрагменты опубликованного контента, которыми поделились участники курса. Разработчики и преподаватели могут создавать дополнительные вложения для трех типов элементов потока: объявлений, заданий и материалов.

Учителя создают объявления в верхней части страницы потока в пользовательском интерфейсе Класса. Учителя создают задания и материалы, нажимая кнопку «Создать» на вкладке «Задания». Разработчики могут создавать их программно с помощью Classroom API.

Задание — это элемент потока, который может принимать материалы, отправленные учащимися. Задания — это единственный тип элементов потока, отображаемых в журнале оценок, которые могут содержать дополнительные вложения.

Что касается элементов потока :

  • Задание или материал могут быть назначены определенной группе студентов курса.
  • Задание может быть оцененным и неоцененным. Преподаватели могут изменить статус оценки задания в любое время.
  • Задание может иметь несколько вложений.
  • Задание может иметь вложения разных типов. Например, одно задание может одновременно содержать Документы Google, видео YouTube и дополнительные вложения.
  • Задание может содержать дополнительные вложения от нескольких разработчиков.
  • Разработчики могут получать и изменять информацию о любом элементе потока с помощью одного из своих дополнительных вложений.
  • Разработчики могут сдать, вернуть или вернуть материалы, отправленные учащимися для задания, которое включает в себя одно из их дополнительных вложений.
  • Разработчики могут устанавливать оценки только для отдельных работ учащихся в созданных ими заданиях.

Скопированные элементы потока

Преподаватели могут скопировать элемент потока, скопировав курс, повторно используя задание или опубликовав элемент потока в нескольких курсах. Прочтите наше руководство по скопированному контенту , чтобы понять, как надстройка может справиться с этими сценариями.

Учреждение пользователя

API Google Classroom не возвращает идентификаторы учебного заведения, здания или любого другого членства пользователя выше уровня курса.