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 la que deseas que los estudiantes interactúen.
Dentro de 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 descubrimiento de archivos adjuntos y carga la URL de lanzamiento del complemento. Cualquier parámetro de consulta de iframe relevante se pasa 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 se adjuntará a su elemento de transmisión. La aplicación del complemento puede restringir el contenido que se muestra según si el elemento del flujo es un anuncio, una tarea o material del curso. Luego, la aplicación del complemento realiza llamadas a la API de Classroom para crear el archivo adjunto y adjuntarlo 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. Se cierra el iframe y el profesor ve los archivos adjuntos, que puede obtener una vista previa o quitar de la tarea (Figura 3). El profesor completa el flujo de creación asignando el elemento de transmisión 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
- En la apertura inicial, 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.
- Un profesor debe poder buscar o explorar contenido que se pueda adjuntar.
- El complemento puede proporcionar una variedad de vistas, como contenido reciente, mi contenido y filtrar por habilidades de aprendizaje.
- El complemento debe proporcionar la capacidad de crear un elemento nuevo 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 la experiencia del usuario.
Estado de las licencias
Si tu complemento requiere una licencia para tu producto, se debe mostrar un mensaje claro para explicar cómo un profesor sin licencia puede remediar la situación. Considera también ocultar o inhabilitar el contenido que no está disponible para un profesor debido a restricciones de licencias.