Версия 1.1, 5 декабря 2024 г.
Критерии, указанные на этой странице, применяются ко всем надстройкам для Classroom. Ваша надстройка должна соответствовать всем применимым требованиям для размещения в Google Workspace Marketplace и быть совместима с Classroom.
Ключевые слова "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" и "OPTIONAL" в этом документе следует интерпретировать в соответствии с RFC 2119 .
Требования
| ИДЕНТИФИКАТОР | Тип | ||
|---|---|---|---|
| 1.0 | Лицензионное соглашение для конечного пользователя (если применимо) | ||
| 1.1 | Пользователю ДОЛЖНО отображаться понятное сообщение, если у него нет лицензии. В сообщении ДОЛЖНО быть четко указано, почему дополнение нельзя использовать, и предложены действия для исправления ситуации. | РЕКОМЕНДУЕТСЯ | |
| 1.3 | В описании дополнения на Google Workspace Marketplace ДОЛЖНА быть указана подробная информация о лицензионных и подписных требованиях, которые могут потребоваться для его использования. Если дополнение имеет платный тариф, в описании на Marketplace ДОЛЖНА быть ссылка на веб-страницу, где представлена дополнительная информация о ценах или о том, как связаться с менеджером по продажам. | РЕКОМЕНДУЕТСЯ | |
| 2.0 | Вход конечного пользователя | ||
| 2.1 | Преподаватели ОБЯЗАТЕЛЬНО должны входить в систему с помощью Google SSO. Если студентам предлагается войти в систему с помощью дополнения, они ОБЯЗАТЕЛЬНО должны войти, используя Google SSO. | НЕОБХОДИМЫЙ | |
| 2.2 | Дополнение ОБЯЗАТЕЛЬНО должно использовать Google SSO для автоматического входа пользователя при последующих посещениях без отображения запроса на авторизацию. Если подсказка для входа не соответствует текущему авторизованному пользователю, дополнение ДОЛЖНО предложить пользователю нажать кнопку входа и передать подсказку для входа в библиотеку аутентификации для фильтрации недействительных учетных записей. | НЕОБХОДИМЫЙ | |
| 2.7 | Если пользователь Classroom еще не вошел в систему через надстройку (это определяется по подсказке для входа), надстройка ДОЛЖНА отображать кнопку «Войти через Google», чтобы явное действие пользователя запустило процесс входа в систему. Примечание : Это необходимо для соблюдения фирменных стандартов Google, а также помогает избежать блокировщиков всплывающих окон. | НЕОБХОДИМЫЙ | |
| 2.8 | Дополнение ДОЛЖНО отображать информацию о текущем авторизованном пользователе. | РЕКОМЕНДУЕТСЯ | |
| 3.0 | Общий | ||
| 3.1 | Дополнение ДОЛЖНО соответствовать общим правилам утверждения Google Workspace Marketplace . | НЕОБХОДИМЫЙ | |
| 3.2 | Если задача запускается в новой вкладке или окне из любого из iframe-интерфейсов, должно отображаться понятное пользователю сообщение с просьбой вернуться в Classroom. | РЕКОМЕНДУЕТСЯ | |
| 3.3 | Пользователь ДОЛЖЕН завершить весь процесс только с помощью дополнительного рабочего процесса и не переключаться на рабочий процесс courseWork или использовать кнопку «Поделиться классом». | НЕОБХОДИМЫЙ | |
| 3.4 | Выбор локализации: язык ДОЛЖЕН основываться на локальных настройках, установленных браузером, если таковые имеются. | РЕКОМЕНДУЕТСЯ | |
| 3.5 | Если в дополнении задан параметр maxPoints , оно ОБЯЗАТЕЛЬНО должно также устанавливать pointsEarned когда студент завершает работу, используя сохраненные учетные данные преподавателя (рекомендуется), ИЛИ когда преподаватель открывает работу в iframe «Обзор студенческой работы». | НЕОБХОДИМЫЙ | |
| 3.9 | Дополнения ДОЛЖНЫ соответствовать рекомендациям WCAG 2.1 уровня AA по доступности. Разработчики дополнений должны самостоятельно подтвердить выполнение этого требования на момент подачи заявки и то, что дополнение продолжает соответствовать требованиям при последующих изменениях. | РЕКОМЕНДУЕТСЯ | |
| 3.10 | Любые ошибки, с которыми сталкивается пользователь, ДОЛЖНЫ быть понятны человеку. | РЕКОМЕНДУЕТСЯ | |
| 3.11 | Если объект studentViewUri , teacherViewUri или studentWorkViewUri запускается из скопированного задания или скопированного курса, дополнение НЕ ДОЛЖНО отображать страницу ошибки во фрейме. | НЕОБХОДИМЫЙ | |
| 4.0 | Обнаружение вложений | ||
| 4.1 | Если для прикрепления файла требуется работа студента, то вложенный файл ОБЯЗАТЕЛЬНО должен содержать studentWorkReviewUri , чтобы он рассматривался как файл типа "Задание", а не как файл типа "Содержание". | НЕОБХОДИМЫЙ | |
| 4.2 | Интерфейс iframe для обнаружения вложений ОБЯЗАТЕЛЬНО должен предоставлять пользовательский интерфейс, предлагающий как минимум одно из следующих возможностей:
| НЕОБХОДИМЫЙ | |
| 4.3 | Учитель ДОЛЖЕН иметь возможность находить и получать доступ ко всему доступному ему контенту/заданиям. | РЕКОМЕНДУЕТСЯ | |
| 4.4 | Учитель ДОЛЖЕН иметь возможность предварительно ознакомиться с содержанием/заданием, прежде чем принять решение о его прикреплении к заданию. | РЕКОМЕНДУЕТСЯ | |
| 4.5 | Если учителю необходимо выполнить дополнительную работу по созданию контента/задания перед его прикреплением, эту работу СЛЕДУЕТ выполнить непосредственно во фрейме. | РЕКОМЕНДУЕТСЯ | |
| 5.0 | Мнение студента | ||
| 5.1 | При запуске studentViewUri дополнение НЕ ДОЛЖНО выводить пользователя из iframe для завершения задания.Если дополнение выводит пользователя из iframe, ОБЯЗАТЕЛЬНО должно быть сообщение или иное указание для студентов вернуться в Classroom. | РЕКОМЕНДУЕТСЯ | |
| 5.2 | Если дополнительная активность появляется вне iframe, то в iframe ДОЛЖЕН отображаться предварительный просмотр этой задачи. | РЕКОМЕНДУЕТСЯ | |
| 5.3 | Если в задании присутствует кнопка или ссылка с пометкой «Сдать», она ОБЯЗАТЕЛЬНО должна вызывать API-запрос для отправки работы ученика на проверку учителем. | НЕОБХОДИМЫЙ | |
| 6.0 | Мнение учителя | ||
| 6.1 | Учитель ДОЛЖЕН видеть то, что увидит ученик, когда будет выполнять задание. | РЕКОМЕНДУЕТСЯ | |
| 7.0 | Рецензирование студенческой работы | ||
| 7.1 | Если запущен объект studentWorkReviewUri , дополнение ДОЛЖНО отображать работу ученика для проверки учителем внутри iframe. Дополнительные материалы могут быть размещены за пределами iframe. | НЕОБХОДИМЫЙ | |
| 7.2 | Дополнение НЕ ДОЛЖНО включать навигацию между студентами в представлении studentWorkReviewUri . Навигация между студентами ДОЛЖНА осуществляться ТОЛЬКО в пользовательском интерфейсе Classroom. | НЕОБХОДИМЫЙ | |
| 8.0 | Поддержка мобильных устройств в классе | ||
| 8.1 | Когда мобильное приложение Classroom запускает teacherViewUri , studentViewUri или studentWorkReviewUri , URL-адрес ДОЛЖЕН открывать либо мобильное нативное приложение партнера, либо мобильное веб-приложение партнера, и в любом случае должен содержать прямую ссылку на соответствующее представление. Если устройство не поддерживается, пользователю ДОЛЖНО быть показано сообщение о том, что это неподдерживаемое устройство, и в идеале — какие устройства поддерживаются. | НЕОБХОДИМЫЙ | |
| 8.2 | Задания для студентов ДОЛЖНЫ выполняться на мобильном устройстве. | РЕКОМЕНДУЕТСЯ | |
| 9.0 | Дополнительные функции | ||
| 9.1 | Если преподаватели могут вставлять ссылки на ваш контент в виде вложений, вам СЛЕДУЕТ преобразовать ссылки в дополнительные вложения . | РЕКОМЕНДУЕТСЯ | |
| 9.2 | Если вы используете интеграцию с CourseWork для создания заданий вне Classroom, вам СЛЕДУЕТ по умолчанию создавать вложения для всех ссылок, совместимых с вашим дополнением. | РЕКОМЕНДУЕТСЯ | |
Список изменений
| Версия 1.1 | Обновлено 5 декабря 2024 г. |
| 1.1, 1.3, 3.2, 3.10, 4.4, 5.2 | Изменено с ОБЯЗАТЕЛЬНОГО на РЕКОМЕНДУЕМОЕ. |
| 3.12 | Удаленный. |
| 5.3 | Переформулировано. Недавнее изменение позволяет разработчикам дополнений надежно отправлять работы студентов, используя API. |
| Версия 1.0 | Обновлено 30 апреля 2024 г. |
| 1.1 | Объединили пункты 1.1 и 1.2 в одно требование. |
| 2.1 | Объединили пункты 2.1 и 2.5 в одно требование. |
| 2.2 | Объединили пункты 2.2, 2.3 и 2.4 в одно требование. |
| 3.5 | Объединили пункты 3.5, 3.6 и 3.7 в одно требование. |
| 3.10 | Дополнительное требование: дополнение никогда не должно переходить в непонятное или невосстановимое состояние. |
| 3.11, 3.12 | Объединили пункты 5.5, 5.6, 6.3, 6.4, 7.5 и 7.6 в два новых требования. |
| 4.2 | Расширено описание приемлемых вариантов проведения экспериментов по выявлению привязанности. |
| 4.3 | Перенумеровано, ранее 4.2. Также изменено с ОБЯЗАТЕЛЬНОГО на РЕКОМЕНДУЕМОЕ. |
| 4.4 | Перенумерован, ранее 4.3. |
| 4.5 | Перенумерован, ранее 4.4. |
| 5.2 | Перенумерован, ранее 5.3. |
| 5.3 | Перенумерован, ранее 5.2. |
| 9.1 | Добавлена рекомендация по преобразованию вставленных ссылок в формат вложений. |
| 9.2 | Добавлена рекомендация по созданию дополнительных вложений по умолчанию при программном создании заданий по курсовой работе. |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | Удаленный. |
| Версия 0.3 | Обновлено 22 ноября 2022 г. |
| 2.3 | Исправление в руководстве по подсказкам при входе в систему. |
| 2.4 | Включен сценарий, в котором требуется реализация hd . |
| 3.2 | Перефразировано "предоставить путь". |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | Добавлены необходимые инструкции по написанию текста курса и рекомендации для полей studentViewUri , teacherViewUri и studentWorkReviewUri . |
| Версия 0.2 | Обновлено 29 октября 2021 г. |
| 1.3 | Текст был немного изменен, чтобы сделать его более понятным. |
| 3.1 | Добавлено: «Дополнение ДОЛЖНО соответствовать общим правилам утверждения GWM, размещенным на их веб-сайте». |
| 3.9 | В стандартах WCAG слово «ОБЯЗАТЕЛЬНО» было изменено на «РЕКОМЕНДУЕТСЯ». |
| 5.1 | Заменено с REQUIRED на RECOMMENDED. |
| 5.3 | Добавлено: «Если дополнение выходит за пределы iframe, в iframe ОБЯЗАТЕЛЬНО должен отображаться предварительный просмотр задачи». |
| 5.4 | Добавлено: «Если дополнение выходит за пределы iframe, студентам ДОЛЖНО быть предложено вернуться в Classroom». |
| 8.1 | Добавлено: «Если устройство не поддерживается, пользователю ОБЯЗАТЕЛЬНО должно быть показано сообщение, информирующее его о том, что это неподдерживаемое устройство, и в идеале — какие устройства поддерживаются». |
| 8.2 | Выполнение студентами заданий на выезде изменено с ОБЯЗАТЕЛЬНОГО на РЕКОМЕНДУЕМОЕ. |
| Версия 0.1 | Обновлено 22 сентября 2021 г. |
| Первый релиз. |