Integración de CourseWork

Los desarrolladores pueden usar la API de Google Classroom para interactuar con el trabajo de curso en Google Classroom. Una aplicación que usa la API de esta manera se conoce como integración de CourseWork.

Esta ruta de integración se suele usar para crear y calificar tareas con vínculos a recursos fuera de Classroom. Proporciona más acceso a los desarrolladores a la administración de cursos en comparación con los botones Compartir en Classroom.

Cómo funciona

La función principal de una integración de CourseWork es la creación y administración de tareas, anuncios y materiales del curso con la API de Classroom.

Un ejemplo de un recorrido del usuario común habilitado por una integración de CourseWork es permitir que los profesores descubran, asignen y califiquen contenido desde tu sitio web o aplicación:

  1. Un usuario que es profesor accede a tu sitio web.
  2. El profesor encuentra o crea contenido que quiere compartir con su clase. El profesor hace clic en un botón de tu sitio web para enviar este contenido a Google Classroom.
  3. Tu aplicación envía una solicitud a courses.courseWork.create. La solicitud contiene un objeto CourseWork en su cuerpo que contiene lo siguiente:
    • El ID del curso de destino
    • Es el título de la tarea.
    • Es la descripción de texto de la tarea.
    • Un link Material con la URL al contenido que seleccionó el profesor
    • De manera opcional, la puntuación máxima que se puede obtener para el contenido seleccionado
  4. Aparecerá una tarea nueva en Classroom con un vínculo adjunto. El vínculo hace referencia a la URL especificada en la solicitud create. Consulta la Figura 1 para ver un ejemplo.
  5. También aparecerá una nueva columna para la tarea en el libro de calificaciones de Classroom, que incluirá la puntuación máxima (si se proporciona).
  6. Los estudiantes reciben la tarea y hacen clic en link Material para abrir la URL proporcionada en una pestaña nueva y ver o completar el contenido en tu sitio web. De manera opcional, proporciona controles para que el estudiante entregue la tarea.
  7. De manera opcional, envía una solicitud a courses.courseWork.studentSubmissions.modifyAttachments para agregar archivos adjuntos a una entrega de un estudiante, como un archivo de Google Drive o un link Material que dirija a su trabajo en tu sitio web.
  8. De manera opcional, envía una solicitud a courses.courseWork.studentSubmissions.patch para establecer la calificación del estudiante para la tarea.

Cómo editar una tarea de CourseWork con un archivo adjunto de material de vínculo

Figura 1: Vista de profesor cuando se edita una tarea con link Material creada por una integración de CourseWork.

Como alternativa, puedes llamar a courses.announcements.create o courses.courseWorkMaterials.create para crear un anuncio o material del curso en lugar de una tarea. Consulta las páginas Cómo crear y administrar tareas y Cómo establecer y actualizar calificaciones para obtener descripciones detalladas de las acciones relevantes de la API de Classroom.

Consideraciones

Ten en cuenta lo siguiente antes de decidir si una integración de CourseWork es la opción correcta para las necesidades de tu producto.

  • Debes autorizar al usuario y solicitarle su consentimiento. Realizas solicitudes a la API en nombre del usuario. Esto significa, por ejemplo, que no puedes crear tareas en ningún curso de Google Classroom. Solo puedes crear tareas en los cursos que imparte el usuario autorizado.
  • Necesitas una forma para que el usuario seleccione un curso para recibir el contenido. Considera usar courses.list para obtener una lista de los cursos que imparte el usuario y, luego, permitir que el usuario seleccione uno o más de los cursos de la lista.
  • Cuando un usuario hace clic en un link Material en Classroom, el vínculo se abre en una pestaña nueva. Tu servidor no recibirá información de Classroom cuando se abra la URL.
  • Un profesor puede modificar o borrar el trabajo del curso independientemente del desarrollador. Esto significa que el conocimiento de un desarrollador sobre el curso podría estar desactualizado. Si necesitas estar al tanto de los cambios en el curso, considera configurar notificaciones push para los cambios en el curso.
  • Un profesor puede crear trabajos en la IU de Classroom con vínculos pegados a URLs de tu sitio web. El material de curso creado de esta manera es propiedad exclusiva del profesor, por lo que no podrás ver, modificar ni establecer calificaciones de envío con la API de Classroom.