Estrategia de implementación

En esta página, se proporciona una descripción general breve de las interacciones clave entre la 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á las respuestas de los estudiantes. ya que es posible que quieras impedir que el profesor agregue los tipos de actividades archivos adjuntos. Verifica el valor del parámetro de consulta itemType que se pasado cuando se abrió el iframed del complemento. Solo acepta el tipo courseWork las respuestas de los estudiantes.

  • Según las selecciones de los profesores, realiza una o más solicitudes complementarias de create a 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 la vista de profesores iframe están diseñados para presentar contenido al usuario, en lugar de modificar un Tarea de Classroom. Considera tomar las siguientes medidas respecto de estas vistas:

  • Cuando se abre 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 una courseWork.GetAddOnContextRequest. courseWorkMaterials.GetAddOnContextRequest o announcements.GetAddOnContextRequest según el itemType para validar y el rol del usuario específico.
  • Si el usuario actual es estudiante, asocia el submissionId desde respuesta con el trabajo del estudiante. Esto es obligatorio para pasar las calificaciones y para mostrar el trabajo de los alumnos a los profesores en la herramienta de calificación el submissionIds coincidencia en todas las vistas.
  • Si el complemento ya conoce attachmentId, muestra la opción de archivos adjuntos.
  • De lo contrario, debe ocurrir que la publicación principal de este archivo adjunto se haya se copió de otra publicación o curso. Usa copyHistory para identificar la copia reciente que conoce el complemento y copia la configuración en cree un nuevo modelo correspondiente del adjunto en el complemento. Luego, mostrar la IU del archivo adjunto adecuada.