Integración de CourseWork

Los desarrolladores pueden usar la API de Google Classroom para interactuar con los cursos 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 usa comúnmente para crear y calificar tareas con vínculos a recursos fuera de Classroom. Proporciona más acceso de desarrollador 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 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 docente 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 incluye lo siguiente:
    • Es 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 del contenido seleccionado por el profesor.
    • Es el puntaje máximo que se puede obtener para el contenido seleccionado (opcional).
  4. En Classroom, aparecerá una tarea nueva 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 proporcionó.
  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, puedes proporcionar controles para que el estudiante entregue la tarea.
  7. De manera opcional, puedes enviar una solicitud a courses.courseWork.studentSubmissions.modifyAttachments para agregar archivos adjuntos a la entrega de 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, envía 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 Crea y administra tareas y Establece y actualiza 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 adecuada para las necesidades de tu producto.

  • Debes autorizar al usuario y solicitar su consentimiento. Realizas solicitudes a la API en nombre del usuario. Por ejemplo, no puedes crear tareas en ningún curso de Google Classroom, sino solo en los cursos que imparte el usuario autorizado.
  • Necesitas una forma para que el usuario seleccione un curso y reciba 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 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 de forma independiente del desarrollador. Esto significa que el conocimiento de un desarrollador sobre el curso puede quedar desactualizado. Si necesitas estar al tanto de los cambios en los cursos, considera configurar notificaciones push para los cambios en los cursos.
  • Un profesor puede crear tareas en la IU de Classroom con vínculos pegados a URLs de tu sitio web. El profesor es el único propietario de los trabajos creados de esta manera, por lo que no podrás ver, modificar ni establecer calificaciones de entrega con la API de Classroom.