Вложение Discovery iframe — это начальный вид, показываемый учителю при открытии надстройки во время создания задания Classroom. Вложение — это контент или активность, с которыми вы хотите, чтобы ученики взаимодействовали.
В рамках курса «Класс» преподаватель создает новую публикацию (например, задание, объявление или вопрос) и выбирает дополнение из раскрывающегося списка дополнений (рисунок 1).
Рисунок 1. Вид создания задания, включая возможные дополнительные опции, которые может прикрепить учитель.
После того, как учитель выбирает надстройку, Classroom создает Attachment Discovery iframe и загружает URL запуска надстройки. Все соответствующие параметры запроса iframe передаются в URL запуска (рисунок 2).
Рисунок 2. Пример пользовательского интерфейса обнаружения вложений в iframe.
Представьте себе представление Attachment Discovery как целевую страницу для учителей в вашем дополнении. Обычно учитель использует веб-приложение партнера в iframe для выбора контента для прикрепления к своему элементу потока. Приложение-дополнение может ограничивать отображаемый контент в зависимости от того, является ли элемент потока объявлением, заданием или учебным материалом. Затем приложение-дополнение выполняет вызовы API класса для создания и прикрепления вложения к заданию.
Когда учитель заканчивает выбирать и создавать вложения, надстройка отправляет полезную нагрузку postMessage с запросом на закрытие iframe. iframe закрывается, и учитель видит вложения, которые он может затем просмотреть или удалить из задания (рисунок 3). Учитель завершает поток создания, назначая элемент потока своим ученикам.
Рисунок 3. Вид создания задания с тремя прикрепленными дополнительными элементами типа «занятие».
Аспекты пользовательского опыта
- При первом открытии надстройка должна предложить учителю войти в систему.
- Для всех вызовов API Classroom требуется единый вход Google. Если у вашего продукта есть отдельная система входа, вам необходимо связать учетные записи.
- Преподаватель должен иметь возможность предварительного просмотра вложения в iframe, прежде чем сделать окончательный выбор.
- Преподаватель должен иметь возможность искать и просматривать прикрепляемый контент.
- Дополнение может предоставлять различные виды просмотра, такие как недавний контент, мой контент и фильтр по навыкам обучения.
- Дополнение должно предоставлять возможность создания нового прикрепляемого элемента из iframe.
Более подробную информацию о требованиях к пользовательскому интерфейсу см. в контрольном списке требований к надстройкам Classroom.
Статус лицензирования
Если для вашего дополнения требуется лицензия на ваш продукт, должно быть показано четкое сообщение, объясняющее, как учитель без лицензии может исправить ситуацию. Рассмотрите также возможность скрытия или отключения контента, который недоступен учителю из-за лицензионных ограничений.