El iframe de Descubrimiento de archivos adjuntos es la vista inicial que se muestra a un profesor cuando abre un complemento durante la creación de una tarea de Classroom. Un archivo adjunto es el contenido o la actividad con los que deseas 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. Durante un período breve (en horas), Classroom permite que el complemento agregue archivos adjuntos a la publicación.
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 descubrimiento de archivos adjuntos y carga la URL de inicio del complemento. Todos los parámetros de consulta de iframe relevantes se pasan a la URL de inicio.
Figura 2: Ejemplo de una IU de descubrimiento de archivos adjuntos en un iframe
El profesor usa la aplicación web del socio, dentro de un iframe, para seleccionar un
adjunto. La app realiza llamadas a la API de Classroom para adjuntar el archivo adjunto a la tarea. Cuando el profesor termina de seleccionar los archivos adjuntos, el complemento envía una carga útil postMessage para solicitar que se cierre el iframe.
El iframe se cierra, y el profesor puede ver los archivos adjuntos que puede elegir para obtener una vista previa o quitarlos de la tarea.
Figura 3: Vista de la creación de una tarea con tres archivos adjuntos de complementos de tipo de actividad.
Consideraciones de UX dentro del iframe
- En la primera apertura, el complemento debe pedirle al profesor que acceda.
- El inicio de sesión único de Google es obligatorio para todas las llamadas a la API de Classroom. Si tu producto tiene un sistema de acceso independiente, debes vincular las cuentas.
- Los profesores deben poder obtener una vista previa de un archivo adjunto dentro del iframe antes de hacer la selección final.
- Los profesores deben poder buscar o explorar contenido que se pueda adjuntar.
- El complemento puede proporcionar una variedad de vistas, como contenido reciente o mi contenido, y filtrar por habilidades de aprendizaje.
- El complemento debe proporcionar la capacidad de crear un nuevo elemento que se pueda adjuntar desde el iframe.
Consulta la lista de tareas de requisitos del complemento de Classroom para obtener más detalles sobre los requisitos de UX.
Cómo mostrar el estado de la licencia dentro del iframe
Si el complemento requiere una licencia y el profesor no tiene una, se debe presentar un mensaje claro al profesor en el que se le informen los próximos pasos adecuados para solucionar la situación. Esto es para evitar cualquier confusión que pueda surgir de las restricciones de licencias.
También te recomendamos que el complemento cumpla con lo siguiente:
- Muestra el nivel de licencia del profesor dentro del iframe de descubrimiento de adjuntos.
- Oculta o inhabilita el contenido que no está disponible para los profesores debido a restricciones en el nivel de las licencias.