REST Resource: courses.courseWork.studentSubmissions

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 (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Campos
courseId

string

Es el identificador del curso.

Solo lectura.

courseWorkId

string

Es el identificador del trabajo del curso al que corresponde.

Solo lectura.

id

string

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

string

Es el identificador del estudiante propietario de esta entrega.

Solo lectura.

creationTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

state

enum (SubmissionState)

Estado de esta entrega.

Solo lectura.

late

boolean

Indica si este envío se retrasa.

Solo lectura.

draftGrade

number

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

number

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

string

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

map (key: string, value: object (RubricGrade))

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 "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

assignedRubricGrades

map (key: string, value: object (RubricGrade))

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 "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

courseWorkType

enum (CourseWorkType)

Tipo de trabajo del curso para este envío.

Solo lectura.

associatedWithDeveloper

boolean

Indica si esta entrega de un estudiante está asociada con el proyecto de Play Console que realiza la solicitud.

Consulta courseWork.create para obtener más información.

Solo lectura.

submissionHistory[]

object (SubmissionHistory)

El historial de la entrega (incluye los historiales de estado y calificaciones).

Solo lectura.

previewVersion

enum (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

object (AssignmentSubmission)

Enviar contenido cuando CourseWorkType sea ASSIGNMENT

Los estudiantes pueden modificar este contenido con studentSubmissions.modifyAttachments.

shortAnswerSubmission

object (ShortAnswerSubmission)

Enviar contenido cuando CourseWorkType sea SHORT_ANSWER_QUESTION

multipleChoiceSubmission

object (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

string

Opcional. ID de criterio.

levelId

string

Opcional. ID opcional del nivel seleccionado. Si está vacío, no se seleccionó ningún nivel.

points

number

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 (Attachment)
    }
  ]
}
Campos
attachments[]

object (Attachment)

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 attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Campos
Campo de unión attachment. Datos de archivos adjuntos. Las direcciones (attachment) solo pueden ser una de las siguientes opciones:
driveFile

object (DriveFile)

Archivo adjunto de Google Drive.

youTubeVideo

object (YouTubeVideo)

Video adjunto de YouTube.

form

object (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

string

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

string

Selección del estudiante.

SubmissionHistory

El historial del envío. Actualmente, se incluyen los historiales de estado y calificaciones.

Representación JSON
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
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

object (StateHistory)

La información del historial del estado de la entrega, si está presente.

gradeHistory

object (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 (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Campos
state

enum (State)

La etapa de canalización del flujo de trabajo.

stateTimestamp

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

actorUserId

string

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 (GradeChangeType)
}
Campos
pointsEarned

number

El numerador de la calificación en este momento en el historial de calificaciones de entregas.

maxPoints

number

El denominador de la calificación en este momento en el historial de calificaciones de entregas.

gradeTimestamp

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

actorUserId

string

El profesor que hizo el cambio de calificación.

gradeChangeType

enum (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

get

Muestra la entrega de un estudiante.

list

Muestra una lista de las entregas de los estudiantes que el solicitante puede ver, teniendo en cuenta los alcances de OAuth de la solicitud.

modifyAttachments

Modifica los archivos adjuntos de la entrega del estudiante.

patch

Actualiza uno o más campos de la entrega de un alumno.

reclaim

Reclama el envío de un alumno en nombre del alumno al cual pertenece.

return

Muestra la entrega de un estudiante.

turnIn

Entrega la entrega de un estudiante.