Estrategia de implementación

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 o announcements.GetAddOnContextRequest basado en itemType para validar el rol del usuario y obtener el valor supportsStudentWork.
  • 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; la submissionIds 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.