Introducción

Las tareas de Classroom se denominan elementos de CourseWork, que se encuentran en la página Trabajo en clase de cualquier curso de Classroom. Si bien existen cuatro tipos de elementos de trabajo en clase, esta guía se centra únicamente en el tipo "Tarea". Si quieres obtener información para administrar los otros tipos de trabajo en clase, lee nuestra guía para administrar trabajos en clase.

Google Classroom tiene dos formas de integrarse en el flujo de trabajo de las tareas: el botón para compartir de Classroom y la API de Classroom. El botón para compartir permite que los usuarios compartan contenido como cualquier elemento de la 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 alumnos, y las devoluciones de calificaciones.

A continuación, revisaremos las diferencias clave entre estas dos ofertas para desarrolladores. Más específicamente, trabajaremos en las diferencias en la implementación y en cada fase del ciclo de vida de las tareas: creación de tareas, entregas de los estudiantes y calificación o comentarios.

Comprende el ciclo de vida de las tareas

Antes de abordar las diferencias entre el botón para compartir y la API de CourseWork, definamos lo que consideramos que es 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 alumnos con las tareas dentro de Classroom.

Existen cinco pasos principales que se deben tener en cuenta durante la integración con las tareas de Classroom:

1. Se creó la tarea.
2. La tarea se comparte con los estudiantes.
3. El estudiante completa la tarea.
4. El estudiante le envía la tarea al profesor.
5. El profesor revisa y califica las tareas.

La integración con las tareas de Classroom permite que los profesores y alumnos trabajen entre Classroom y aplicaciones de terceros sin problemas. En lugar de administrar los detalles de una tarea o las entregas de los estudiantes, los usuarios pueden confiar en tu aplicación para administrar estos detalles por ellos.

Implementación

La primera área de diferencia entre el botón para compartir y la API de CourseWork es la implementación. Desde la perspectiva de los desarrolladores, el botón de compartir es un método más fácil de compartir contenido en Classroom, ya que solo requiere incluir el recurso de JavaScript necesario y agregar una etiqueta de botón para compartir. En su forma más sencilla, la integración del botón para 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>

Puedes obtener más información para realizar la integración con el botón Compartir aquí.

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 prácticas recomendadas para la integración en una API. Esto no resulta tan importante si tu plataforma ya aprovecha otras funciones de la API de Classroom, como la lista.

Cómo crear y compartir tareas

Si bien el botón para compartir y la API de CourseWork habilitan los dos primeros pasos del flujo de trabajo de tareas, como crear y compartir la tarea con los estudiantes, hay algunas diferencias cruciales que debes considerar antes de elegir una solución.

En esencia, ambas soluciones habilitan la capacidad de publicar vínculos o archivos como tareas en Classroom. Esto sirve como un flujo de trabajo eficaz para los profesores que, de otro modo, se verían obligados a implementar 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 un anuncio.

Ambas ofertas exponen todos los tipos de publicaciones de Classroom, excepto las tareas con cuestionario. A continuación, puedes encontrar un resumen de todos los tipos de publicaciones y de si están expuestas.

Tipo de publicación	Botón Compartir	API de CourseWork
Assignment	X	X
Tarea con cuestionario
Pregunta: Respuesta breve	X	X
Pregunta de opción múltiple	X	X
Material	X	X
Anuncio	X	X

La aplicación también puede especificar de manera programática funciones como la especificación del título y la descripción para ambas soluciones. Si bien la integración del botón para compartir permite a los usuarios configurar campos como la fecha de vencimiento, el tema, el modo individual y la cantidad de puntos dentro del diálogo emergente, una app de terceros no puede configurar de manera programática. La API, por otro lado, expone todos estos campos para el acceso de lectura y escritura.

El botón para compartir no permite que la aplicación especifique campos específicos para los tipos de pregunta, p.ej., opciones de opción múltiple.

Cómo modificar tareas

Uno de los beneficios de la integración con la API de Classroom es eliminar la necesidad de que los usuarios sincronicen manualmente los cambios cambiantes de sus tareas. El botón para compartir carece de funcionalidad para actualizar o borrar tareas de manera programática, por lo que el usuario tendría que realizar las modificaciones necesarias a través de la IU de Classroom.

La API de CourseWork permite modificar y borrar tareas que creó tu aplicación, además de recuperar detalles de cualquier tarea publicada en los cursos del usuario. Sin embargo, es importante tener en cuenta que esa consola para desarrolladores no puede modificar los elementos de CourseWork no creados por la misma consola para desarrolladores. Este modelo de permisos se extiende al resto del ciclo de vida de las tareas, p.ej., no se puede acceder a la administración de las entregas y calificaciones de los estudiantes para estos elementos de CourseWork.

Sincronizar tareas automáticamente

Con las notificaciones push de Pub/Sub, tu aplicación puede suscribirse a notificaciones que activan un evento cuando hay cambios en los elementos de CourseWork y sus entregas asociadas de los estudiantes. Esto permite que tu aplicación sincronice tareas con facilidad, ya que elimina la necesidad de realizar verificaciones continuas para ver si se actualizó el contenido en Classroom.

Cómo completar y enviar tareas

Cada tarea está asociada con N entregas de los estudiantes, en la que N es el número de estudiantes a los que se asignó la tarea. En otras palabras, para cada tarea, hay una entrega del estudiante asociada con 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 las puede recuperar con los extremos GET y LIST de las entregas de los estudiantes.

Tanto el botón para compartir como la API de CourseWork permiten agregar vínculos o archivos a la entrega de un estudiante para una tarea. El botón para compartir permite hacerlo a través de un flujo de trabajo similar al del diálogo de creación de tareas de los profesores y de la API de CourseWork a través del extremo studentSubmissions.modifyAttachments. Sin embargo, debido a las restricciones de permisos de la API que se describieron antes, esta funcionalidad se limita a los elementos de CourseWork que creó tu aplicación. Esta misma restricción no se aplica al botón para compartir: 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 sirve para un caso de uso 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 sus tareas a la tarea incorrecta y se olviden de entregar su trabajo, ya que solo el botón de compartir está limitado a la capacidad de los estudiantes de entregar sus tareas.

A partir de noviembre de 2019, el botón Compartir ofrece la posibilidad de especificar a qué curso agregará un archivo adjunto un estudiante, pero no admite la selección automática de una tarea. Ten en cuenta el riesgo de que los estudiantes se entreguen a la tarea incorrecta.

Cómo revisar y calificar tareas

La última parte del ciclo de vida de una tarea vuelve al profesor. Una vez que los estudiantes hayan entregado correctamente la tarea, el profesor podrá revisarla de la forma que le resulte más conveniente. En el caso de los archivos almacenados en Drive, pueden revisarlos directamente en la calificación de Classroom. Sin embargo, no se puede acceder a aplicaciones de terceros en la herramienta de calificación de Classroom. La implicancia de esta experiencia es que los profesores deben navegar por varias pestañas mientras revisan y califican las tareas.

Por el momento, el botón Compartir no ofrece una solución para calificar y devolver tareas. Si bien las funciones como los comentarios de las entregas de los estudiantes no se exponen por el momento 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 se pueden especificar solo para los elementos del flujo de CourseWork (tipos Tarea y Pregunta). Solo están disponibles en formato numérico y se pueden asignar como calificación final o borrador.

Para devolver o calificar las tareas, primero se debe entregar la entrega del estudiante. Actualmente, existe una discrepancia entre el funcionamiento de la IU y la API de Classroom.

Resumen de diferencias

Para resumir todo lo que se revisó en las secciones anteriores, la tabla de abajo muestra una comparación en paralelo del botón para compartir y la API de CourseWork para las cuatro categorías antes mencionadas: 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 las APIs en la Consola del administrador y supervisar más de cerca
Cómo crear y compartir tareas	Redirecciona a los profesores al diálogo para compartir del botón Compartir en Classroom Los usuarios pueden publicar todos los tipos de elementos de novedades, excepto uno Se pueden especificar menos campos Uno habilita la creación de tareas sin la posibilidad de extraer o modificar los datos de las tareas.	No es necesario establecer el diálogo del botón para compartir La mayoría de los campos de las tareas de Classroom se pueden especificar Capacidad de modificar el trabajo de curso creado por tu aplicación Permite que la app extraiga todos los datos de las tareas de Classroom.
Completa y envía tareas	Redirecciona a los estudiantes al diálogo para compartir el botón Compartir en Classroom Permite que los alumnos adjunten su entrega a cualquier tarea de Classroom. Uno habilita el archivo adjunto de presentación, sin la capacidad de extraer o modificar los datos de presentación No permite que los estudiantes entreguen la tarea	No es necesario establecer el diálogo del botón para compartir Solo permite que los estudiantes adjunten su entrega a las tareas creadas por tu app Permite que tu aplicación modifique las entregas de los estudiantes creadas por tu aplicación Permite que los alumnos entreguen sus tareas.
Revisar y calificar tareas	No se admite la especificación o devolución de calificaciones	Permite que la app extraiga todos los datos de entrega de los alumnos de Classroom en nombre de un profesor. Expone la capacidad de asignar calificaciones a los estudiantes, ya sea como borrador o final. Expone la capacidad de modificar las calificaciones de los alumnos. Expone la capacidad de devolver las calificaciones a los estudiantes.