Las tareas de 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 aprender a gestionar los otros tipos de Trabajo en clase, lee nuestra guía para administrar el Trabajo en clase.
Google Classroom tiene dos formas de integrarse en un flujo de trabajo de tareas: el botón para compartir de Classroom y la API de Classroom. El botón Compartir permite a los usuarios compartir contenido como cualquier elemento de transmisión a través de un diálogo emergente de Classroom, mientras que la API de Classroom habilita un flujo de trabajo de tareas de principio a fin que incluye la creación de tareas, la creación y administración de las entregas de los estudiantes, y la devolución de calificaciones.
Aquí, revisaremos las diferencias clave entre estas dos ofertas para desarrolladores. Más específicamente, analizaremos las diferencias en la implementación y en cada fase del ciclo de vida de la tarea: creación de tareas, envíos de los estudiantes y calificación o comentarios.
Comprende el ciclo de vida de las tareas
Antes de pasar a las diferencias entre el botón de 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 los profesores y los estudiantes interactúan con las tareas en Classroom.
Existen cinco pasos principales que debes tener en cuenta cuando realices la integración con las tareas de Classroom:
- Se creó 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 estudiantes trabajen sin problemas entre Classroom y aplicaciones de terceros. En lugar de administrar los detalles de una tarea o los envíos de los estudiantes, los usuarios pueden confiar en tu aplicación para que los administre por ellos.
Implementación
La primera área de diferencia entre el botón de compartir y la API de CourseWork es la implementación. Desde la perspectiva de un desarrollador, el botón Compartir es un método más fácil para compartir contenido en Classroom, ya que solo requiere incluir el recurso JavaScript necesario y agregar una etiqueta de botón Compartir. En su forma más simple, la integración del botón de compartir de 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>
La API de CourseWork, por otro lado, 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 es menos preocupante si tu plataforma ya aprovecha otras funciones de la API de Classroom, como la asignación de grupos.
Cómo crear y compartir tareas
Si bien tanto el botón de compartir como la API de CourseWork habilitan los primeros dos pasos del flujo de trabajo de la tarea, que son crearla y compartirla con los estudiantes, hay algunas diferencias fundamentales 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 potente para los profesores que, de otro modo, 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 posibilidad de publicar contenido como tarea, debes considerar si tu aplicación necesita la flexibilidad de publicar este contenido como otros tipos de actividades de clase o incluso como un anuncio.
Ambas ofertas muestran todos los tipos de publicaciones de Classroom, excepto las tareas de cuestionarios. A continuación, encontrarás 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 con cuestionario | ||
| Pregunta: Respuesta breve | 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 funciones como especificar el título y la descripción para ambas soluciones. Si bien la integración del botón de compartir permite a los usuarios establecer campos como la fecha límite, el tema, el modo individualizado y la cantidad de puntos dentro del diálogo emergente, una app de terceros no puede establecerlos de forma programática. La API, por otro lado, expone todos estos campos para el acceso de lectura y escritura.
Cómo modificar tareas
Uno de los beneficios de la integración con la API de Classroom es que elimina la necesidad de que los usuarios sincronicen manualmente los detalles cambiantes de sus tareas. El botón de compartir no tiene la funcionalidad para actualizar o borrar tareas de forma programática, por lo que el usuario deberá realizar las modificaciones necesarias 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 de desarrollador no puede modificar los elementos de CourseWork que no se crearon con ella. Este modelo de permisos se extiende al resto del ciclo de vida de la tarea, p.ej., no se puede acceder a la administración de las calificaciones y las entregas de los estudiantes para estos elementos de CourseWork.
Sincroniza tareas automáticamente
Con las notificaciones push de Pub/Sub, tu aplicación puede suscribirse a notificaciones que activen un evento cuando haya cambios en los elementos de CourseWork y sus envíos asociados de los estudiantes. Esto permite que tu aplicación sincronice las tareas fácilmente, ya que elimina la necesidad de realizar verificaciones continuas para ver si se actualizó el contenido en Classroom.
Completar y enviar tareas
Cada tarea está asociada con N entregas de estudiantes, donde N es la cantidad de estudiantes a los que se les asignó la tarea. En otras palabras, para cada tarea, hay una entrega asociada para cada estudiante, a la que se puede acceder con un ID único. Estas entregas de los estudiantes se crean automáticamente y tu aplicación puede recuperarlas con los extremos GET y LIST de las entregas de los estudiantes.
Tanto el botón de compartir como la API de CourseWork admiten la adición de vínculos o archivos a la entrega de un alumno para una tarea. El botón de 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 extremo studentSubmissions.modifyAttachments. Sin embargo, debido a las restricciones de permisos de 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 de uso compartido, ya que los estudiantes pueden agregar su trabajo a cualquier tarea que seleccionen en Classroom.
Finaliza el flujo de trabajo del estudiante
Si bien la restricción de permisos de CourseWork no es útil para las 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 se olviden de entregar su trabajo, ya que solo el botón de compartir está limitado para que los estudiantes puedan entregar sus tareas.
Revisa y califica tareas
La última parte del ciclo de vida de la tarea vuelve al profesor. Una vez que los estudiantes hayan entregado correctamente la tarea, el profesor podrá revisarla de la forma que sea más conveniente. En el caso de los archivos almacenados en Drive, pueden revisarlos directamente en la herramienta de calificación de Classroom. Sin embargo, no se puede acceder a las aplicaciones de terceros en la calificación 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 de compartir no ofrece una solución para calificar y devolver tareas. Si bien, en la actualidad, las funciones como los comentarios de las entregas de los estudiantes no se exponen a través de la API, es posible calificar y devolver esas calificaciones a los estudiantes a través de los extremos studentSubmissions.patch y studentSubmissions.return. Las calificaciones solo se pueden especificar para los elementos del flujo de CourseWork (Tareas y tipos de 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 analizó en las secciones anteriores, en la siguiente tabla, se muestra una comparación en paralelo del botón de compartir y la API de CourseWork para las cuatro categorías mencionadas 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 directa y rápida | Requiere configurar claves de API, habilitar APIs en la Consola del administrador y realizar una supervisión más estrecha. |
| Cómo crear y compartir tareas |
|
|
| Completa y envía tareas |
|
|
| Cómo revisar y calificar tareas | No se admite la especificación ni la devolución de calificaciones. |
|