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 denomina integración de CourseWork.

Esta ruta de integración se usa comúnmente para crear y calificar tareas con vínculos a recursos fuera de Classroom. Proporciona más acceso para desarrolladores a la administración del trabajo de curso 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 que permite 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 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 emite 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
    • El título de la tarea
    • La descripción de texto de la tarea
    • Un link Material con la URL del contenido seleccionado por el profesor.
    • De manera opcional, la puntuación máxima que se puede obtener para el contenido seleccionado
  4. Aparece una tarea nueva en Classroom con un archivo adjunto de vínculo. El vínculo hace referencia a la URL especificada en la solicitud create. Consulta un ejemplo en la Figura 1.
  5. También aparece una columna nueva para la tarea en el libro de calificaciones de Classroom, incluida 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 de tu sitio web. De manera opcional, proporciona controles para que el estudiante entregue la tarea.
  7. De manera opcional, emite una solicitud a courses.courseWork.studentSubmissions.modifyAttachments para agregar archivos adjuntos a un trabajo entregado por un estudiante, como un archivo de Google Drive o link Material que apunte al trabajo del estudiante en tu sitio web.
  8. De manera opcional, emite una solicitud a courses.courseWork.studentSubmissions.patch para establecer la calificación del estudiante para la tarea.

Edita una tarea de CourseWork con un material adjunto de vínculo

Figura 1: Vista del profesor cuando 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 Crear y administrar el trabajo de curso y Establecer y actualizar calificaciones para obtener descripciones detalladas de las acciones pertinentes 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 solicitar su consentimiento. Realizas solicitudes a la API en nombre del usuario. Esto significa, por ejemplo, que no puedes crear trabajo de curso en ningún curso de Google Classroom; solo puedes crear trabajo de curso en los cursos que dicta 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 dicta 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 link Material en Classroom, el vínculo se abre en una pestaña nueva. Tu servidor no recibirá ninguna información de Classroom cuando se abra la URL.
  • Un profesor puede modificar o borrar el trabajo de curso independientemente del desarrollador. Esto significa que el conocimiento del trabajo de curso por parte de un desarrollador podría quedar desactualizado. Si necesitas estar al tanto de los cambios en el trabajo de curso, considera configurar notificaciones push para los cambios en el trabajo de curso.
  • Un profesor puede crear trabajo de curso en la IU de Classroom con vínculos pegados a URLs en tu sitio web. El trabajo de curso creado de esta manera es propiedad exclusiva del profesor, por lo que no podrás ver, modificar ni establecer calificaciones de entrega con la API de Classroom.