Estrategia de implementación

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 tipo courseWork 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 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 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.