- Recurso: StudentSubmission
- RubricGrade
- AssignmentSubmission
- Archivo adjunto
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Estado
- GradeHistory
- GradeChangeType
- Métodos
Recurso: StudentSubmission
Entrega de los estudiantes para los trabajos del curso.
Se generan StudentSubmission
elementos cuando se crea un elemento CourseWork
.
Es posible que las entregas de los alumnos a las que nunca se haya accedido (es decir, con state
= NUEVO) no tengan una hora de creación ni de actualización.
Representación JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Campos | |
---|---|
courseId |
Es el identificador del curso. Solo lectura. |
courseWorkId |
Es el identificador del trabajo del curso al que corresponde. Solo lectura. |
id |
Es el identificador asignado por el aula para la entrega del alumno. Esta es única entre las entregas para el trabajo relevante del curso. Solo lectura. |
userId |
Es el identificador del estudiante propietario de esta entrega. Solo lectura. |
creationTime |
Hora de creación de este envío. Es posible que esta opción se desactive si el estudiante no accedió a este elemento. Solo lectura. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
updateTime |
Es la hora de la última actualización de este envío. Es posible que esta opción se desactive si el estudiante no accedió a este elemento. Solo lectura. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
state |
Estado de esta entrega. Solo lectura. |
late |
Indica si este envío se retrasa. Solo lectura. |
draftGrade |
Calificación pendiente opcional. Si no la estableces, no se establecerá ninguna calificación. Este valor no debe ser negativo. Se permiten los valores decimales (es decir, no números enteros), pero se redondean a dos decimales. Solo los profesores del curso pueden verlo y modificarlo. |
assignedGrade |
Calificación opcional. Si no la estableces, no se establecerá ninguna calificación. Este valor no debe ser negativo. Se permiten los valores decimales (es decir, no números enteros), pero se redondean a dos decimales. Solo los profesores del curso pueden modificarlo. |
rubricId |
Solo salida. Es el identificador de la rúbrica adjunta actualmente a este trabajo del curso y que se usa para calificar la entrega de este estudiante. Este ID estará vacío si no hay una rúbrica. Este ID refleja la rúbrica actualmente activa y cambia si los profesores la borran y la vuelven a crear. Solo lectura. |
draftRubricGrades |
Calificaciones pendientes de la rúbrica según los criterios de la rúbrica. Este mapa estará vacío si no hay una rúbrica adjunta al trabajo del curso o si se adjunta una rúbrica, pero no se establecieron calificaciones según ningún criterio. Las entradas solo se propagan para las calificaciones que se configuraron. Clave: El ID del criterio de la rúbrica Solo lectura. Es un objeto que contiene una lista de pares |
assignedRubricGrades |
Se asignaron las calificaciones de la rúbrica según los criterios de la rúbrica. Este mapa estará vacío si no hay una rúbrica adjunta al trabajo del curso o si se adjunta una rúbrica, pero no se establecieron calificaciones en ningún Criterio. Las entradas solo se propagan para las calificaciones que se configuraron. Clave: El ID del criterio de la rúbrica Solo lectura. Es un objeto que contiene una lista de pares |
alternateLink |
Vínculo absoluto a la entrega en la IU web de Classroom. Solo lectura. |
courseWorkType |
Tipo de trabajo del curso para este envío. Solo lectura. |
associatedWithDeveloper |
Indica si esta entrega de un estudiante está asociada con el proyecto de Play Console que realiza la solicitud. Consulta Solo lectura. |
submissionHistory[] |
El historial de la entrega (incluye los historiales de estado y calificaciones). Solo lectura. |
previewVersion |
Solo salida. Es la versión preliminar de la API. Esto se debe configurar para acceder a las nuevas funciones de la API que están disponibles para los desarrolladores en el Programa de versión preliminar. |
Campo de unión content . Contenido del envío. El tipo específico depende del valor de course_work_type . content puede ser solo uno de los siguientes: |
|
assignmentSubmission |
Enviar contenido cuando CourseWorkType sea ASSIGNMENT Los estudiantes pueden modificar este contenido con |
shortAnswerSubmission |
Enviar contenido cuando CourseWorkType sea SHORT_ANSWER_QUESTION |
multipleChoiceSubmission |
Enviar contenido cuando CourseWorkType sea MULTIPLE_CHOICE_QUESTION. |
RubricGrade
Una rúbrica de calificación establecida para el envío del estudiante. Existe, como máximo, una entrada por criterio de rúbrica.
Representación JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
Campos | |
---|---|
criterionId |
Opcional. ID de criterio. |
levelId |
Opcional. ID opcional del nivel seleccionado. Si está vacío, no se seleccionó ningún nivel. |
points |
Opcional. Puntos opcionales asignados a este criterio, por lo general, según el nivel. Los niveles pueden tener puntos o no. Si no se establece, no se establecieron puntos para este criterio. |
AssignmentSubmission
Trabajo de un estudiante para una tarea.
Representación JSON |
---|
{
"attachments": [
{
object ( |
Campos | |
---|---|
attachments[] |
Archivos adjuntos que agregó el estudiante Es posible que aún no existan los archivos de Drive que corresponden a los materiales con un modo para compartir STUDENT_COPY si el estudiante no accedió a la tarea en Classroom. Algunos metadatos de archivos adjuntos solo se propagan si el usuario que realiza la solicitud tiene permiso para acceder a ellos. Los campos Identifier y alternateLink siempre están disponibles, pero es posible que otros (por ejemplo, title) no lo estén. |
Conexión
Se agregó el archivo adjunto al trabajo en la tarea del estudiante.
Cuando se crean archivos adjuntos, no se admite la configuración del campo form
.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión attachment . Datos de archivos adjuntos. Las direcciones (attachment ) solo pueden ser una de las siguientes opciones: |
|
driveFile |
Archivo adjunto de Google Drive. |
youTubeVideo |
Video adjunto de YouTube. |
link |
Vínculo adjunto. |
form |
Archivo adjunto de Formularios de Google. |
ShortAnswerSubmission
Trabajo de un estudiante para una pregunta de respuesta corta.
Representación JSON |
---|
{ "answer": string } |
Campos | |
---|---|
answer |
Respuesta del alumno a una pregunta de respuesta corta |
MultipleChoiceSubmission
El trabajo del alumno en una pregunta de opción múltiple
Representación JSON |
---|
{ "answer": string } |
Campos | |
---|---|
answer |
Selección del estudiante. |
SubmissionHistory
El historial del envío. Actualmente, se incluyen los historiales de estado y calificaciones.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión type . Type of SubmissionHistory puede ser StateHistory o GradeHistory. Las direcciones (type ) solo pueden ser una de las siguientes opciones: |
|
stateHistory |
La información del historial del estado de la entrega, si está presente. |
gradeHistory |
La información del historial de calificaciones de la entrega, si está presente. |
StateHistory
El historial de cada estado en el que estuvo este envío.
Representación JSON |
---|
{
"state": enum ( |
Campos | |
---|---|
state |
La etapa de canalización del flujo de trabajo. |
stateTimestamp |
Indica cuándo el envío ingresó a este estado. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
actorUserId |
El profesor o alumno que realizó el cambio |
Estado
Estados posibles de un envío.
Enumeradores | |
---|---|
STATE_UNSPECIFIED |
No se especificó ningún estado. Nunca debe devolverse. |
CREATED |
Se creó el envío. |
TURNED_IN |
El estudiante entregó un documento asignado, que puede ser una plantilla o no. |
RETURNED |
El profesor le devolvió el documento asignado al alumno. |
RECLAIMED_BY_STUDENT |
El alumno entregó el documento asignado y, luego, eligió anular la entrega de la tarea, lo que le permitió volver a tener el control de esa persona como propietario. |
STUDENT_EDITED_AFTER_TURN_IN |
El alumno editó su entrega después de entregarla. Actualmente, solo se usa en Preguntas, cuando el alumno edita su respuesta. |
GradeHistory
El historial de cada calificación de esta entrega.
Representación JSON |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
Campos | |
---|---|
pointsEarned |
El numerador de la calificación en este momento en el historial de calificaciones de entregas. |
maxPoints |
El denominador de la calificación en este momento en el historial de calificaciones de entregas. |
gradeTimestamp |
Cuándo se cambió la calificación de la entrega. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
actorUserId |
El profesor que hizo el cambio de calificación. |
gradeChangeType |
El tipo de calificación cambió en este momento en el historial de calificaciones de las entregas. |
GradeChangeType
Tipos de cambio de calificación posibles.
Enumeradores | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
No se especificó ningún tipo de cambio de calificación. Nunca debe devolverse. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
Es un cambio en el numerador de la calificación preliminar. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
Es un cambio en el numerador de la calificación asignada. |
MAX_POINTS_CHANGE |
Es un cambio en el denominador de la calificación. |
Métodos |
|
---|---|
|
Muestra la entrega de un estudiante. |
|
Muestra una lista de las entregas de los estudiantes que el solicitante puede ver, teniendo en cuenta los alcances de OAuth de la solicitud. |
|
Modifica los archivos adjuntos de la entrega del estudiante. |
|
Actualiza uno o más campos de la entrega de un alumno. |
|
Reclama el envío de un alumno en nombre del alumno al cual pertenece. |
|
Muestra la entrega de un estudiante. |
|
Entrega la entrega de un estudiante. |