REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Es la entrega de un estudiante para el trabajo del curso.

Los elementos StudentSubmission se generan cuando se crea un elemento CourseWork.

Es posible que los envíos de los estudiantes a los que nunca se accedió (es decir, con state = NEW) no tengan una fecha de creación o 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

Identificador del trabajo del curso al que corresponde.

Solo lectura.
id

string

Es el identificador asignado por Classroom para la entrega del estudiante. Este valor es único entre los envíos para el trabajo del curso correspondiente.

Solo lectura.
userId

string

Es el identificador del estudiante propietario de esta entrega.

Solo lectura.
creationTime

string (Timestamp format)

Es la fecha y hora de creación de este envío. Este campo puede no estar configurado si el estudiante no accedió a este elemento.

Solo lectura.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Fecha y hora de la última actualización de este envío. Este campo puede no estar configurado si el estudiante no accedió a este elemento.

Solo lectura.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Estado de este envío.

Solo lectura.
late

boolean

Indica si este envío se retrasó.

Solo lectura.
draftGrade

number

Calificación pendiente opcional. Si no se establece, no se asignó ninguna calificación. Este valor no debe ser negativo. Se permiten valores decimales (es decir, no enteros), pero se redondean a dos decimales.

Solo los profesores del curso pueden ver y modificar esta información.
assignedGrade

number

Calificación opcional. Si no se establece, no se asignó ninguna calificación. Este valor no debe ser negativo. Se permiten valores decimales (es decir, no 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 el envío del estudiante.

Este ID está vacío si no hay rúbrica. Este ID refleja la rúbrica activa actualmente y cambia si los profesores borran y vuelven a crear la rúbrica.

Solo lectura.

draftRubricGrades

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

Calificaciones pendientes de la rúbrica según los criterios de esta.

Este mapa está vacío si no hay una rúbrica adjunta a este trabajo del curso o si hay una rúbrica adjunta, pero no se establecieron calificaciones en ningún criterio. Las entradas solo se completan para las calificaciones que se establecieron. Clave: Es 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))

Son las calificaciones asignadas a la rúbrica según sus criterios.

Este mapa está vacío si no hay una rúbrica adjunta a este trabajo del curso o si hay una rúbrica adjunta, pero no se establecieron calificaciones en ningún criterio. Las entradas solo se completan para las calificaciones que se establecieron. Clave: Es 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 el que se realiza este envío.

Solo lectura.
associatedWithDeveloper

boolean

Indica si el envío de este estudiante está asociado con el proyecto de Play Console que realiza la solicitud.

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

Solo lectura.
submissionHistory[]

object (SubmissionHistory)

Historial del envío (incluye el historial de estados y calificaciones).

Solo lectura.
previewVersion

enum (PreviewVersion)

Solo salida. Es la versión preliminar de la API. Se debe configurar para acceder a las nuevas capacidades de la API que se ponen a disposición de 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)

Es el contenido de la entrega cuando courseWorkType es ASSIGNMENT.

Los estudiantes pueden modificar este contenido con studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Es el contenido del envío cuando courseWorkType es SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Es el contenido del envío cuando courseWorkType es MULTIPLE_CHOICE_QUESTION.

RubricGrade

Es la calificación de la rúbrica establecida para el envío del estudiante. Hay, como máximo, una entrada por criterio de rúbrica.

Representación JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Campos
criterionId

string

Opcional. Es el ID del criterio.
levelId

string

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

number

Opcional. Puntos opcionales asignados para este criterio, por lo general, según el nivel. Los niveles pueden tener puntos o no. Si no se configura, no se establecieron puntos para este criterio.

AssignmentSubmission

Es el trabajo de un estudiante para una tarea.

Representación JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Campos
attachments[]

object (Attachment)

Son los archivos adjuntos que agregó el estudiante. Es posible que los archivos de Drive que corresponden a materiales con un modo de uso compartido de STUDENT_COPY aún no existan si el estudiante no accedió a la tarea en Classroom.

Algunos metadatos de adjuntos solo se completan si el usuario solicitante tiene permiso para acceder a ellos. Los campos identifier y alternateLink siempre están disponibles, pero otros (por ejemplo, title) pueden no estarlo.

Archivo adjunto

Se agregó un archivo adjunto al trabajo de la tarea del estudiante.

Cuando crees archivos adjuntos, no se admitirá 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. Son los datos del archivo adjunto. Las direcciones (attachment) solo pueden ser una de las siguientes opciones:
driveFile

object (DriveFile)

Es un archivo adjunto de Google Drive.
youTubeVideo

object (YouTubeVideo)

Es un archivo adjunto de video de YouTube.
form

object (Form)

Es un 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

Es la respuesta del estudiante a una pregunta de respuesta corta.

MultipleChoiceSubmission

Trabajo de un estudiante en una pregunta de opción múltiple.

Representación JSON 
{
  "answer": string
}
Campos
answer

string

Es la opción que selecciona el estudiante.

SubmissionHistory

Es el historial del envío. Actualmente, esto incluye el historial de estados 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. Es el tipo de SubmissionHistory y puede ser StateHistory o GradeHistory. Las direcciones (type) solo pueden ser una de las siguientes opciones:
stateHistory

object (StateHistory)

Es la información del historial de estado del envío, si está presente.
gradeHistory

object (GradeHistory)

Es la información del historial de calificaciones del envío, si está presente.

StateHistory

Historial de cada estado en el que se encontró este envío.

Representación JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Campos
state

enum (State)

Es la etapa de la canalización del flujo de trabajo.
stateTimestamp

string (Timestamp format)

Fecha y hora en que se envió la solicitud y se ingresó a este estado.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
actorUserId

string

El profesor o estudiante que realizó el cambio

Estado

Son los estados posibles de un envío.

Enumeraciones
STATE_UNSPECIFIED No se especificó ningún estado. Nunca debería 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 devolvió el documento asignado al estudiante.
RECLAIMED_BY_STUDENT El estudiante entregó el documento asignado y, luego, eligió "anular la entrega" de la tarea, lo que le devolvió el control como propietario.
STUDENT_EDITED_AFTER_TURN_IN El estudiante editó su entrega después de entregarla. Actualmente, solo lo usan las preguntas cuando el estudiante edita su respuesta.

GradeHistory

Historial de cada calificación de este envío.

Representación JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Campos
pointsEarned

number

Es el numerador de la calificación en este momento del historial de calificaciones de la entrega.
maxPoints

number

Es el denominador de la calificación en este momento del historial de calificaciones de la entrega.
gradeTimestamp

string (Timestamp format)

Fecha y hora en que se cambió la calificación del envío.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
actorUserId

string

Es el profesor que realizó el cambio de calificación.
gradeChangeType

enum (GradeChangeType)

Es el tipo de cambio de calificación en este momento del historial de calificaciones de la entrega.

GradeChangeType

Son los tipos de cambios de calificación posibles.

Enumeraciones
UNKNOWN_GRADE_CHANGE_TYPE No se especificó ningún tipo de cambio de calificación. Nunca debería devolverse.
DRAFT_GRADE_POINTS_EARNED_CHANGE Es un cambio en el numerador de la calificación preliminar.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Cambio en el numerador de la calificación asignada.
MAX_POINTS_CHANGE Cambio en el denominador de la calificación

Métodos

get

 Devuelve un envío del estudiante.

list

 Devuelve una lista de las entregas de los estudiantes que el solicitante tiene permiso para 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 un envío del estudiante.

reclaim

 Reclama una entrega de un estudiante en nombre del estudiante propietario.

return

 Devuelve un envío del estudiante.

turnIn

 Entrega la tarea de un estudiante.