iframe «Открытие вложений» — это начальное окно, отображаемое учителю при открытии дополнения во время создания задания в Classroom. Вложение — это контент или задание, с которым, как предполагается, будут взаимодействовать ученики.
From within a Classroom course, a teacher creates a new post (for example, an assignment, announcement, or question) and selects an add-on from the add-on drop-down list (Figure 1).
Figure 1. View of an assignment creation including the possible add-on options a teacher can attach.
После того как учитель выберет дополнение, Classroom создаст iframe для обнаружения вложений и загрузит URL-адрес запуска дополнения. Все соответствующие параметры запроса iframe передаются на URL-адрес запуска (Рисунок 2).
Figure 2. An example of an attachment discovery UI in an iframe.
Представьте себе раздел «Поиск вложений» как главную страницу для преподавателей в вашем дополнении. Как правило, преподаватель использует веб-приложение партнера внутри iframe, чтобы выбрать контент для прикрепления к элементу своей трансляции. Приложение дополнения может ограничивать отображаемый контент в зависимости от того, является ли элемент трансляции объявлением, заданием или учебным материалом. Затем приложение дополнения выполняет вызовы API Classroom для создания и прикрепления вложения к заданию.
Когда преподаватель заканчивает выбор и создание вложений, дополнение отправляет сообщение postMessage с просьбой закрыть iframe. iframe закрывается, и преподаватель видит вложения, которые он может просмотреть или удалить из задания (Рисунок 3). Преподаватель завершает процесс создания, назначая элемент потока своим ученикам.
Figure 3. View of an assignment creation with three activity-type add-on attachments.
Учет пользовательского опыта
- On initial opening, the add-on must prompt the teacher to sign in.
- Google single sign-on is required for all Classroom API calls. If your product has a separate login system, you must link accounts.
- A teacher must be able to preview an attachment within the iframe before making their final selection.
- A teacher should be able to search for, or browse through, attachable content.
- The add-on may provide a variety of views such as recent content, my content, and filter by learning skills.
- The add-on must provide an ability to create a new attachable item from within the iframe.
See the Classroom add-on requirements checklist for more details on user experience requirements.
Статус лицензирования
Если для вашего дополнения требуется лицензия на продукт, следует отобразить четкое сообщение, объясняющее, как учитель без лицензии может исправить ситуацию. Также следует рассмотреть возможность скрытия или отключения контента, недоступного учителю из-за ограничений лицензирования.