Las tareas en Classroom se denominan elementos de CourseWork, que se pueden encontrar en la página Trabajo en clase de cualquier curso de Classroom. Si bien hay cuatro tipos de elementos de Trabajo en clase, esta guía se enfoca solo en el tipo “Tarea”. Si quieres obtener información para administrar los otros tipos de Trabajo en clase, lee nuestra guía Administra el trabajo en clase.
Google Classroom tiene dos formas de integrarse con un flujo de trabajo de tareas: el botón Compartir en Classroom y la API de Classroom. El botón Compartir permite que los usuarios compartan contenido como cualquier elemento de transmisión a través de un diálogo emergente de Classroom, mientras que la API de Classroom permite un flujo de trabajo de tareas de principio a fin que incluye la creación de tareas, la creación y administración de entregas de estudiantes y la devolución de calificaciones.
Aquí revisaremos las diferencias clave entre estas dos ofertas para desarrolladores. En concreto, analizaremos las diferencias en la implementación y en cada fase del ciclo de vida de la tarea: creación de tareas, entregas de estudiantes y calificación o comentarios.
Comprende el ciclo de vida de la tarea
Antes de pasar a las diferencias entre el botón Compartir y la API de CourseWork, primero definamos lo que consideramos el ciclo de vida de una tarea en el contexto de Classroom. Esto te ayudará a comprender cómo interactúan los profesores y los estudiantes con las tareas en Classroom.
Hay cinco pasos principales que debes tener en cuenta cuando realices la integración con las tareas de Classroom:
- Se crea la tarea.
- La tarea se comparte con los estudiantes.
- El estudiante completa la tarea.
- El estudiante envía la tarea al profesor.
- El profesor revisa y califica las tareas.
La integración con las tareas de Classroom permite que los profesores y los estudiantes trabajen sin problemas entre Classroom y las aplicaciones de terceros. En lugar de administrar los detalles de una tarea o las entregas de los estudiantes, los usuarios pueden confiar en que tu aplicación los administre por ellos.
Implementación
La primera área de diferencia entre el botón Compartir y la API de CourseWork es la implementación. Desde la perspectiva del desarrollador, el botón Compartir es un método más sencillo para compartir contenido en Classroom, ya que solo requiere incluir el recurso de JavaScript necesario y agregar una etiqueta de botón Compartir. En su forma más simple, la integración del botón Compartir en Classroom puede verse como el siguiente fragmento:
<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>
Por otro lado, la API de CourseWork forma parte de la API de REST de la API de Google Classroom, que requiere configurar y habilitar claves de API con la consola de Google Cloud y seguir las prácticas recomendadas para la integración con una API. Esto no es un problema si tu plataforma ya aprovecha otras funciones de la API de Classroom, como la creación de listas.
Crea y comparte tareas
Si bien el botón Compartir y la API de CourseWork permiten los dos primeros pasos del flujo de trabajo de tareas (crear y compartir la tarea con los estudiantes), hay algunas diferencias cruciales que debes tener en cuenta antes de elegir una solución.
En esencia, ambas soluciones permiten publicar vínculos o archivos como tareas en Classroom. Esto sirve como un flujo de trabajo eficaz para los profesores que, de lo contrario, se verían obligados a realizar un flujo de trabajo de copiar y pegar entre Classroom y la aplicación de terceros. Si bien ambas soluciones admiten la capacidad de publicar contenido como una tarea, debes considerar si tu aplicación necesita la flexibilidad de publicar este contenido como otros tipos de Trabajo en clase o incluso como un anuncio.
Ambas ofertas exponen todos los tipos de publicaciones de Classroom, excepto las tareas de cuestionario. A continuación, se incluye un resumen de todos los tipos de publicaciones y si están expuestos.
| Tipo de publicación | Botón Compartir | API de CourseWork |
|---|---|---|
| Asignación | X | X |
| Tarea de cuestionario | ||
| Pregunta: Respuesta corta | X | X |
| Pregunta: Opción múltiple | X | X |
| Material | X | X |
| Anuncio | X | X |
Tu aplicación también puede especificar de forma programática la funcionalidad, como especificar el título y la descripción para ambas soluciones. Si bien la integración del botón Compartir permite que los usuarios configuren campos como la fecha de entrega, el tema, el modo individualizado y la cantidad de puntos en el diálogo emergente, una app de terceros no puede configurarlos de forma programática. Por otro lado, la API expone todos estos campos para el acceso de lectura y escritura.
Modifica las tareas
Eliminar la necesidad de que los usuarios sincronicen manualmente los detalles cambiantes de sus tareas es uno de los beneficios de la integración con la API de Classroom. El botón Compartir no tiene la funcionalidad para actualizar o borrar tareas de forma programática, por lo que el usuario debe realizar cualquier modificación necesaria a través de la IU de Classroom.
La API de CourseWork permite modificar y borrar las tareas que creó tu aplicación, así como recuperar los detalles de las tareas publicadas en los cursos del usuario. Sin embargo, es importante tener en cuenta que la consola del desarrollador no puede modificar los elementos de CourseWork que no creó. Este modelo de permisos se extiende al resto del ciclo de vida de la tarea, por ejemplo, la administración de las entregas y calificaciones de los estudiantes, no se puede acceder a estos elementos de CourseWork.
Sincroniza las tareas automáticamente
Con las notificaciones push de Pub/Sub, tu aplicación puede suscribirse a las notificaciones que activan un evento cuando hay cambios en los elementos de CourseWork y sus entregas de estudiantes asociadas. Esto permite que tu aplicación sincronice las tareas con facilidad, ya que elimina la necesidad de realizar verificaciones continuas para ver si se actualizó el contenido en Classroom.
Completa y envía las tareas
Cada tarea está asociada con N entregas de estudiantes, en las que N es la cantidad de estudiantes a los que se asignó la tarea. En otras palabras, para cada tarea, hay una entrega de estudiante asociada para cada estudiante, a la que se puede acceder con un ID único. Estas entregas de estudiantes se crean automáticamente y tu aplicación puede recuperarlas con los extremos GET y LIST de las entregas de estudiantes.
El botón Compartir y la API de CourseWork admiten agregar vínculos o archivos a la entrega de un estudiante para una tarea. El botón Compartir permite esto a través de un flujo de trabajo similar al diálogo de creación de tareas del profesor, y la API de CourseWork a través del studentSubmissions.modifyAttachments. Sin embargo, debido a las restricciones de permisos de la API que se detallaron anteriormente, esta funcionalidad se limita a los elementos de CourseWork que creó tu aplicación. Esta misma restricción no se aplica al botón Compartir: los estudiantes pueden agregar su trabajo a cualquier tarea que seleccionen de Classroom.
Finaliza el flujo de trabajo del estudiante
Si bien la restricción de permisos de CourseWork no sirve para plataformas que no admiten la creación de tareas, un beneficio es que las plataformas de terceros pueden evitar que los estudiantes envíen la tarea incorrecta y que se olviden de entregar su trabajo, ya que solo el botón Compartir está limitado por la capacidad de los estudiantes para entregar sus tareas.
Revisa y califica las tareas
La última parte del ciclo de vida de la tarea vuelve al profesor. Una vez que los estudiantes entregan correctamente su tarea, el profesor puede revisarla de la manera que le parezca más adecuada. En el caso de los archivos almacenados en Drive, pueden revisarlos directamente en el calificador de Classroom. Sin embargo, no se puede acceder a las aplicaciones de terceros en el calificador de Classroom. La implicación de esta experiencia es que los profesores deben navegar por varias pestañas mientras revisan y califican las tareas.
Actualmente, el botón Compartir no ofrece ninguna solución para calificar y devolver tareas. Si bien las funciones, como los comentarios de las entregas de los estudiantes, no se exponen actualmente a través de la API, es posible calificar y devolver esas calificaciones a los estudiantes a través de los studentSubmissions.patch y studentSubmissions.return. Las calificaciones se pueden especificar solo para los elementos de transmisión de CourseWork (tipos de tareas y preguntas). Solo están disponibles en formato numérico y se pueden asignar como borrador o calificación final.
Resumen de las diferencias
Para resumir todo lo que se revisó en las secciones anteriores, en la siguiente tabla, se muestra una comparación en paralelo del botón Compartir y la API de CourseWork para las cuatro categorías analizadas anteriormente: implementación, creación y uso compartido de tareas, finalización y envío de tareas, y revisión y calificación de tareas.
| Botón Compartir | API de CourseWork | |
|---|---|---|
| Implementación | Solo unas pocas líneas de JavaScript, lo que hace que la implementación sea sencilla y rápida | Requiere configurar claves de API, habilitar APIs en la Consola del administrador y una supervisión más detallada |
| Crea y comparte tareas |
|
|
| Completa y envía las tareas |
|
|
| Revisa y califica las tareas | No se admite la especificación ni la devolución de calificaciones |
|