Введение

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

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

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

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

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

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

  1. Задание создано.
  2. Задание передается студентам.
  3. Студент выполняет задание.
  4. Студент отправляет задание преподавателю.
  5. Преподаватели проверяют и оценивают задания.

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

Диаграмма, показывающая пять шагов к заданию

Выполнение

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

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

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

Создание и совместное использование заданий

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Проверка и оценка заданий

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

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

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

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

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