Введение

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

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 является частью API REST API Google Classroom, который требует настройки и включения ключей API с помощью консоли Google Cloud и соблюдения передовых методов интеграции с API. Это не так важно, если ваша платформа уже использует другие функции API Classroom, такие как rostering .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

По состоянию на ноябрь 2019 года кнопка «Поделиться» предлагает возможность указать, к какому курсу студент добавляет вложение, но она по-прежнему не поддерживает автоматический выбор задания. Рассмотрите риск отправки студентами неправильного задания.

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

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

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

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

Резюме различий

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

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