Введение

Задания в Classroom называются элементами CourseWork, которые можно найти на странице «Задания» любого курса Classroom. Хотя существует четыре типа заданий «Задания», в этом руководстве основное внимание уделяется только типу «Задание». Если вы хотите узнать, как управлять другими типами заданий в классе, прочтите наше руководство по управлению заданиями в классе .

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

Здесь мы рассмотрим ключевые различия между этими двумя предложениями для разработчиков. Более конкретно, мы проработаем различия в реализации и на каждом этапе жизненного цикла задания: создание задания, подачи заявок студентами и выставление оценок/обратная связь.

Понимание жизненного цикла задания

Прежде чем перейти к различиям между кнопкой «Поделиться» и API CourseWork, давайте сначала определим, что мы считаем жизненным циклом задания в контексте Classroom. Это поможет вам понять, как преподаватели и учащиеся взаимодействуют с заданиями в Классе.

При интеграции с заданиями Класса следует учитывать пять основных шагов:

  1. Задание создано.
  2. Задание передается учащимся.
  3. Учащийся выполняет задание.
  4. Учащийся сдает задание учителю.
  5. Учитель проверяет и оценивает задания.

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

Схема, показывающая пять шагов выполнения задания

Выполнение

Первая область различия между кнопкой «Поделиться» и API CourseWork — это реализация . С точки зрения разработчика, кнопка «Поделиться» — это более простой способ поделиться контентом в Классе, поскольку для этого требуется только включить необходимый ресурс JavaScript и добавить тег кнопки «Поделиться». В простейшей форме интеграция кнопки «Поделиться» в Классе может выглядеть так, как показано ниже:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

API CourseWork, с другой стороны, является частью REST API Google Classroom API, который требует настройки и включения ключей API с помощью консоли Google Cloud, а также следования рекомендациям по интеграции с API. Это не вызывает беспокойства, если ваша платформа уже использует другие функции Classroom API, такие как составление реестров .

Создание заданий и обмен ими

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

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

Оба предложения предоставляют все типы публикаций Класса, кроме заданий викторины. Сводную информацию обо всех типах публикаций и о том, публикуются ли они, можно найти ниже.

Тип сообщения Кнопка «Поделиться» Курсовой API
Назначение Х Х
Задание викторины
Вопрос: Короткий ответ Х Х
Вопрос: Множественный выбор Х Х
Материал Х Х
Объявление Х Х

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

Изменение заданий

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

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

Автоматически синхронизировать задания

С помощью push-уведомлений Pub/Sub ваше приложение может подписаться на уведомления, которые вызывают событие при внесении изменений в элементы CourseWork и связанные с ними материалы учащихся. Это позволяет вашему приложению легко синхронизировать задания, устраняя необходимость в постоянных проверках обновлений контента в Классе.

Выполнение и отправка заданий

Каждое задание связано с N материалами учащихся, где N — количество учащихся, которым было назначено задание. Другими словами, для каждого задания существует связанная с каждым студентом работа, доступ к которой можно получить по уникальному идентификатору. Эти материалы учащихся создаются автоматически и могут быть получены вашим приложением с помощью конечных точек GET и LIST материалов учащихся.

И кнопка «Поделиться», и API CourseWork поддерживают добавление ссылок или файлов в заявку учащегося на задание. Кнопка «Поделиться» позволяет сделать это с помощью рабочего процесса, аналогичного диалоговому окну создания задания преподавателя, а API CourseWork — через конечную точку StudentSubmissions.modifyAttachments . Однако из-за ограничений разрешений API, подробно описанных ранее, эта функциональность ограничена элементами CourseWork, созданными вашим приложением. Это же ограничение не распространяется на кнопку «Поделиться» — учащиеся могут добавлять свою работу к любому заданию, которое они выбирают в Классе.

Завершение рабочего процесса ученика

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

Рецензирование и выставление оценок за задания

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

Кнопка «Поделиться» в настоящее время не предлагает решения для оценки и возврата заданий. Хотя такие функции, как комментарии учащихся к материалам, в настоящее время не доступны через API, выставление оценок и возврат этих оценок учащимся возможны через конечные точки StudentSubmissions.patch и StudentSubmissions.return . Оценки можно указывать только для элементов потока CourseWork (типы «Задание» и «Вопрос»). Они доступны только в числовой форме и могут быть присвоены как черновые, так и итоговые оценки.

Краткое описание различий

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

Кнопка «Поделиться» Курсовой API
Выполнение Всего несколько строк JavaScript, что делает реализацию простой и быстрой. Требуется настройка ключей API, включение API в консоли администратора и более тщательный мониторинг.
Создание и обмен заданиями
  • Перенаправляет учителей в диалоговое окно «Поделиться» с кнопкой «Поделиться» в Классе.
  • Пользователи могут публиковать все типы элементов потока, кроме одного.
  • Можно указать меньше полей
  • Один позволяет создавать назначения, но не позволяет извлекать или изменять данные назначения.
  • Нет необходимости в диалоговом окне кнопки «Поделиться»
  • Можно указать большинство полей назначения Класса.
  • Возможность изменять курсовую работу, созданную вашим приложением.
  • Позволяет вашему приложению получать все данные о заданиях из Класса.
Выполнение и отправка заданий
  • Перенаправляет учащихся в диалоговое окно «Поделиться» с кнопкой «Поделиться» в Классе.
  • Позволяет учащимся прикреплять свои материалы к любому заданию Класса.
  • Один включает вложение отправленных данных, без возможности извлекать или изменять данные отправленных данных.
  • Не позволяет учащимся сдать задание
  • Нет необходимости в диалоговом окне кнопки «Поделиться»
  • Позволяет учащимся прикреплять свои работы только к заданиям, созданным вашим приложением.
  • Позволяет вашему приложению изменять материалы учащихся, созданные вашим приложением.
  • Позволяет учащимся сдавать свои задания
Проверка и выставление оценок за задания Нет поддержки указания или возврата оценок.
  • Позволяет вашему приложению получать все данные, отправленные учащимися, из Класса от имени преподавателя.
  • Предоставляет возможность выставлять учащимся оценки как черновые, так и окончательные.
  • Предоставляет возможность изменять оценки учащихся.
  • Предоставляет возможность возвращать оценки учащимся