El iframe de Attachment Discovery es la vista inicial que se muestra a un profesor cuando abre un complemento durante la creación de una tarea de Classroom. Un adjunto es el contenido o la actividad con los que quieres que interactúen los estudiantes.
Desde un curso de Classroom, un profesor crea una publicación nueva (por ejemplo, una tarea, un anuncio o una pregunta) y selecciona un complemento de la lista desplegable de complementos (figura 1).
Figura 1: Vista de la creación de una tarea, incluidas las posibles opciones de complementos que puede adjuntar un profesor.
Una vez que un profesor selecciona un complemento, Classroom crea un iframe de Attachment Discovery y carga la URL de lanzamiento del complemento. Todos los parámetros de consulta de iframe pertinentes se pasan a la URL de lanzamiento (figura 2).
Figura 2: Ejemplo de una IU de descubrimiento de archivos adjuntos en un iframe.
Piensa en la vista de Descubrimiento de archivos adjuntos como la página de destino para los profesores en tu complemento. Por lo general, el profesor usa la aplicación web del socio dentro del iframe para seleccionar el contenido que adjuntará a su elemento de transmisión. La aplicación del complemento puede restringir el contenido que se muestra según si el elemento de la transmisión es un anuncio, una tarea o material del curso. Luego, la aplicación del complemento realiza llamadas a la API de Classroom para crear y adjuntar el archivo adjunto a la tarea.
Cuando el profesor termina de seleccionar y crear archivos adjuntos, el complemento envía una carga útil postMessage que solicita que se cierre el iframe. El iframe se cierra y el profesor ve los archivos adjuntos, que puede previsualizar o quitar de la tarea (figura 3). El profesor completa el flujo de creación asignando el elemento del flujo a sus estudiantes.
Figura 3: Vista de la creación de una tarea con tres archivos adjuntos de complementos de tipo de actividad.
Consideraciones sobre la experiencia del usuario
- Cuando se abra por primera vez, el complemento debe solicitarle al profesor que acceda.
- Se requiere el inicio de sesión único de Google para todas las llamadas a la API de Classroom. Si tu producto tiene un sistema de acceso independiente, debes vincular las cuentas.
- Un profesor debe poder obtener una vista previa de un archivo adjunto dentro del iframe antes de realizar su selección final.
- El profesor debe poder buscar o explorar el contenido adjuntable.
- El complemento puede proporcionar una variedad de vistas, como contenido reciente, mi contenido y filtros por habilidades de aprendizaje.
- El complemento debe proporcionar la capacidad de crear un elemento adjuntable nuevo desde el iframe.
Consulta la lista de requisitos de los complementos de Classroom para obtener más detalles sobre los requisitos de experiencia del usuario.
Estado de las licencias
Si tu complemento requiere una licencia para tu producto, se debe mostrar un mensaje claro que explique cómo un profesor sin licencia puede remediar la situación. También considera ocultar o inhabilitar el contenido que no esté disponible para un profesor debido a restricciones de licencias.