En esta página, se proporciona una descripción general breve de las interacciones clave entre la aplicación web de tu complemento y la API de complementos de Google Classroom.
Iframe de descubrimiento de archivos adjuntos
El iframe de descubrimiento de archivos adjuntos es la página de destino para los profesores en tu complemento. Considera tomar las siguientes medidas respecto a esta vista:
- Cuando se abra el iframe de descubrimiento de archivos adjuntos, crea un
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
oannouncements.GetAddOnContextRequest
basado enitemType
para validar el rol del usuario y obtener el valorsupportsStudentWork
. - Muestra tu IU de descubrimiento o creación de contenido. Puedes omitir los adjuntos de tipo de actividad según el valor de
supportsStudentWork
de la respuesta de validación de inicio. - En función de las selecciones de los profesores, realiza una o más solicitudes de complementos
create
para agregar archivos adjuntos a la tarea.
Otros iframes
El iframe de la vista de alumnos, el iframe de revisión del trabajo de los estudiantes y el iframe de vista de profesor están diseñados para presentar contenido al usuario en lugar de modificar una tarea de Classroom. Considera realizar las siguientes acciones con respecto a estas vistas:
Cuando se abra un iframe, obtén el consentimiento de OAuth del usuario y, luego, valida su función y su ID de archivo adjunto.
- Si el usuario actual es un estudiante, asocia el
submissionId
de la respuesta con el trabajo del estudiante. Esto es obligatorio para aprobar las calificaciones y mostrar el trabajo de los alumnos a los profesores en la herramienta de calificación; lasubmissionIds
coincide con todas las vistas. - Si el complemento ya conoce
attachmentId
, muestra la IU del archivo adjunto correspondiente. - De lo contrario, debe ocurrir que la publicación principal de este archivo adjunto se haya copiado de otra publicación o curso. Usa
copyHistory
para identificar la copia más reciente que el complemento conozca y copia la configuración desde esta para crear un nuevo modelo correspondiente del adjunto en el complemento. Luego, muestra la IU de archivos adjuntos correspondiente.
- Si el usuario actual es un estudiante, asocia el