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:

  • Muestra la IU de creación o descubrimiento 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. Verifica el valor del parámetro de consulta itemType que se pasó cuando se abrió el iframed 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 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 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 aprobar las 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 para crear un nuevo modelo correspondiente del archivo adjunto en el lado del complemento. Luego, muestra la IU de archivo adjunto adecuada.