Estrategia de implementación

En esta página, se proporciona una breve descripción general 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:

  • Mostrar la IU de descubrimiento o creación de contenido

    De manera opcional, determina si el elemento de las novedades aceptará respuestas de los alumnos, ya que es posible que desees evitar que el profesor agregue archivos adjuntos de tipo de actividad. Comprueba el valor del parámetro de consulta itemType que se pasó cuando se abrió el iframe del complemento. Solo el tipo courseWork acepta respuestas de los estudiantes.

  • Según las selecciones del profesor, realiza una o más solicitudes de create del complemento para agregar archivos adjuntos a la tarea.

Otros iframes

El iframe de la vista del estudiante, el iframe de revisión del trabajo del estudiante y el iframe de la vista del 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 rol y el ID del archivo adjunto.
  • Cuando se abre un iframe, crea un courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest o announcements.GetAddOnContextRequest según el itemType para validar el rol del usuario.
  • Si el usuario actual es un estudiante, asocia el submissionId de la respuesta con su trabajo. Esto es obligatorio para devolver calificaciones y mostrar el trabajo de los estudiantes a los profesores en la herramienta de calificación. Los submissionIds coinciden en todas las vistas.
  • Si el complemento ya conoce el attachmentId, muestra la IU de archivo adjunto adecuada.
  • De lo contrario, es posible 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 conoce y copia la configuración de ella para crear un nuevo modelo correspondiente del archivo adjunto en el complemento. Luego, muestra la IU de archivo adjunto adecuada.