La IU de Classroom admite cinco tipos de Trabajo en clase: Tareas, Tareas de cuestionario, Preguntas de respuesta breve, Preguntas de opción múltiple y Materiales. Actualmente, la API de Classroom admite tres de estos tipos, que se conocen como CourseWorkType
para la API: Tareas, preguntas de respuesta breve y preguntas de opción múltiple.
Para acceder a esta funcionalidad, puedes usar el recurso CourseWork, que representa una tarea o una pregunta que se asignó a los alumnos de un curso en particular, incluidos los materiales y los detalles adicionales, como la fecha límite o la puntuación máxima.
Además del recurso CourseWork, puedes administrar las tareas completadas con el recurso StudentSubmission
. En las siguientes secciones, se describen con más detalle.
Crear tareas
Las tareas solo se pueden crear en nombre de los profesores del curso. Si se intenta crear tareas en nombre de un alumno, se mostrará el error 403 PERMISSION_DENIED
. Del mismo modo, los administradores de dominio tampoco pueden crear asignaciones para cursos que no enseñan, y el intento de hacerlo a través de la API también dará como resultado un error 403 PERMISSION_DENIED
.
Cuando creas asignaciones con el método courses.courseWork.create
, puedes adjuntar vínculos como materials
, como se muestra en el siguiente código de muestra:
Java
Python
El resultado incluye un identificador asignado por el servidor que se puede usar para hacer referencia a la asignación en otras solicitudes a la API.
Para incluir materiales vinculados en una tarea creada a través de la API de Classroom, usa un recurso de vínculo que especifique la URL de destino. Classroom recupera automáticamente el título y la imagen de la miniatura. La API de Classroom también admite de forma nativa los materiales de Google Drive y YouTube, que se pueden incluir con un recurso DriveFile o con un recurso de video de YouTube de forma similar.
Para especificar una fecha límite, configura los campos dueDate
y dueTime
en la hora UTC correspondiente. La fecha límite debe ser futura.
Recuperar tareas y preguntas
Puedes recuperar los deberes y las preguntas de los alumnos y profesores del curso correspondiente o de un administrador de dominio. Para recuperar una tarea o pregunta específica, usa courses.courseWork.get. Para recuperar todas las tareas o preguntas (que opcionalmente coinciden con algunos criterios), usa los campos curso.courseWork.list.
El alcance requerido depende de la función que tiene el usuario solicitante en el curso. Si el usuario es alumno, usa uno de los siguientes alcances:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Si el usuario es profesor o administrador de dominio, usa uno de los siguientes alcances:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Tener permisos para recuperar una tarea o pregunta no implica permisos para acceder a materiales o metadatos de materiales. En la práctica, esto significa que es posible que un administrador no vea el título de un archivo adjunto de Drive si no es miembro del curso. Si quieres permitir que los administradores accedan a los archivos del usuario, consulta la guía de delegación de todo el dominio.
Cómo administrar las respuestas de los alumnos
Un recurso StudentSubmission
representa el trabajo y la calificación de un alumno para una tarea o pregunta. Se crea un recurso StudentSubmission
de forma implícita para cada alumno cuando se crea una pregunta o tarea nueva.
En las siguientes secciones, se explican las acciones comunes que administran las respuestas de los alumnos.
Recuperar las respuestas de los alumnos
Los alumnos pueden recuperar sus propias entregas, los profesores pueden recuperar las entregas de todos los alumnos de sus cursos y los administradores de dominio pueden recuperar todas las entregas de todos los alumnos de su dominio. A cada entrega de estudiante se le asigna un identificador; si conoces el identificador, usa courses.courseWork.studentSubmissions.get
para recuperarlo.
Usa el método courses.courseWork.studentSubmissions.list
para obtener recursos StudentSubmission
que coincidan con algunos criterios, como se muestra en el siguiente ejemplo:
Java
Python
Para recuperar recursos StudentSubmission
que pertenecen a un alumno en particular, especifica el parámetro userId
, como se muestra en el siguiente ejemplo:
Java
Python
Los alumnos se identifican con el ID único o la dirección de correo electrónico del usuario, como lo muestra el SDK de Admin de Google. El usuario actual también puede hacer referencia a su propio ID mediante la abreviatura "me"
.
También es posible obtener las entregas de los alumnos para todas las tareas de un curso. Para ello, usa el literal "-"
como courseWorkId
, como se muestra en el siguiente ejemplo:
Java
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
El alcance requerido depende de la función que tiene el usuario solicitante en el curso. Usa el siguiente alcance si el usuario es un profesor o un administrador de dominio:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Usa el siguiente alcance si el usuario es alumno:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
El permiso para recuperar una entrega de un estudiante no implica permisos para acceder a los archivos adjuntos o los metadatos de los archivos adjuntos. En la práctica, esto significa que es posible que un administrador no vea el título de un archivo adjunto de Drive si no es miembro del curso. Si quieres permitir que los administradores accedan a los archivos del usuario, consulta la guía de delegación de todo el dominio.
Agregar archivos adjuntos a la respuesta de un alumno
Puedes adjuntar vínculos a las entregas de los alumnos. Para ello, adjunta un recurso Link
, DriveFile
o YouTubeVideo
. Esto se hace con courses.courseWork.studentSubmissions.modifyAttachments
, como se muestra en el siguiente ejemplo:
Java
Python
Un archivo adjunto de vínculo se define mediante la URL de destino. Classroom recuperará automáticamente el título y la miniatura. Puedes obtener más información sobre los otros materiales en sus respectivas páginas de referencia.
Solo un profesor del curso o el alumno propietario puede modificar el StudentSubmission
. Solo puedes adjuntar Materials
si el CourseWorkType
de la entrega del alumno es ASSIGNMENT
.
El alcance requerido depende de la función que tiene el usuario solicitante en el curso. Usa el siguiente alcance si el usuario es un profesor:
https://www.googleapis.com/auth/classroom.coursework.students
Usa el siguiente alcance si el usuario es alumno:
https://www.googleapis.com/auth/classroom.coursework.me
Administrar el estado de respuesta de los alumnos
Una respuesta de un alumno puede entregarse, entregarse o devolverse. El campo de estado en StudentSubmission
indica el estado actual. Para cambiar el estado, llama a uno de los siguientes métodos:
courses.courseWork.studentSubmissions.turnIn
courses.courseWork.studentSubmissions.return
courses.courseWork.studentSubmissions.reclaim
Todos estos métodos toman un cuerpo vacío. Ejemplo:
Java
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
body={}).execute()
Solo el alumno que posee un StudentSubmission
puede entregarlo o reclamarlo.
Solo se puede reclamar una entrega entregada. Los profesores del curso solo pueden mostrar un objeto StudentSubmission
que tenga el estado de entrega.
Califica las respuestas de los alumnos.
El recurso StudentSubmission
tiene dos campos para almacenar las calificaciones: assignedGrade
, que es la calificación que se informa a los alumnos, y draftGrade
, que es una calificación tentativa que solo pueden ver los profesores. Estos campos se actualizan mediante courses.courseWork.studentSubmissions.patch
con una máscara de campo que contiene los campos adecuados, como se muestra en el siguiente ejemplo.
Java
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
Cuando trabajan con la IU de Classroom, los profesores no pueden asignar una calificación hasta que hayan guardado una calificación preliminar por primera vez. Luego, la calificación asignada se puede devolver a un alumno. Las aplicaciones deben emular este comportamiento. Tu aplicación puede calificar las tareas de un alumno de dos maneras:
Asigna solo el
draftGrade
. Esto resulta útil, por ejemplo, para permitir que el profesor revise las calificaciones de forma manual antes de finalizarlas. Los alumnos no pueden ver las calificaciones preliminares.Asigna el
draftGrade
yassignedGrade
para calificar completamente una tarea.
Enumerar calificaciones asignadas
Para enumerar todas las calificaciones de un elemento del trabajo de curso en particular, explora el objeto de respuesta del método courses.courseWork.studentSubmissions.list
:
Java
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")