En esta página, se proporciona una descripción general breve de las interacciones clave entre tu aplicación web de complementos 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 realizar las siguientes acciones con respecto a esta vista:
Muestra la IU de creación o descubrimiento de contenido.
De forma opcional, determina si el elemento de las novedades aceptará las respuestas de los estudiantes, ya que es posible que quieras evitar que el profesor agregue archivos adjuntos de tipo de actividad. Verifica el valor del parámetro de consulta
itemType
que se pasó cuando se abrió el iframed del complemento. Solo el tipocourseWork
acepta las respuestas de los estudiantes.Según 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 vista de estudiantes, el iframe de revisión de trabajo de los estudiantes y el iframe de vistas de profesores tienen como objetivo presentar contenido al usuario en lugar de modificar una tarea de Classroom. Considera realizar las siguientes acciones con respecto a estas vistas:
- Cuando se abre un iframe, obtén el consentimiento de OAuth del usuario y, luego, valida su función y el ID del archivo adjunto.
- Cuando se abra un iframe, crea un
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
oannouncements.GetAddOnContextRequest
según elitemType
para validar el rol del usuario. - Si el usuario actual es un estudiante, asocia el
submissionId
de la respuesta con el trabajo del estudiante. Esto es necesario para pasar las calificaciones y mostrar el trabajo de los estudiantes a los profesores en la herramienta de calificación.submissionIds
coincide en todas las vistas. - Si el complemento ya conoce
attachmentId
, muestra la IU del adjunto adecuada. - De lo contrario, debe haber una copia de la publicación principal de este archivo adjunto de otra publicación o curso. Usa
copyHistory
para identificar la copia más reciente que el complemento conoce y copia la configuración para crear un nuevo modelo correspondiente del archivo adjunto en el lado del complemento. Luego, muestra la IU del adjunto adecuada.