REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

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 haya accedido (es decir, con state = NEW) 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 Classroom para la entrega del estudiante. Este es único entre los envíos de la tarea del curso relevante.

Solo lectura.
userId

string

Es el identificador del estudiante propietario de esta entrega.

Solo lectura.
creationTime

string (Timestamp format)

Es la hora de creación de este envío. Es posible que no se haya establecido si el estudiante no accedió a este elemento.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 no se haya establecido si el estudiante no accedió a este elemento.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 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, significa que no se estableció 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 esta información y modificarla.
assignedGrade

number

Calificación opcional. Si no se establece, significa que no se estableció 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 modificar esta información.
rubricId

string

Solo salida. Es el identificador de la rúbrica que se adjunta actualmente a este trabajo del curso y que se usa para calificar la entrega 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 la borran y vuelven a crearla.

Solo lectura.

draftRubricGrades

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

Calificaciones pendientes de la rúbrica según sus criterios

Este mapa estará 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))

Calificaciones asignadas en función de los criterios de la rúbrica

Este mapa estará 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)

Es el tipo de trabajo del curso para el que se realiza el envío.

Solo lectura.
associatedWithDeveloper

boolean

Indica si este envío de 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)

El historial del envío (incluye los historiales de estado y calificación)

Solo lectura.
previewVersion

enum (PreviewVersion)

Solo salida. La versión preliminar de la API. Se debe configurar para acceder a las nuevas funciones 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 enviado. 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 de la entrega cuando courseWorkType es SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Contenido de la entrega cuando courseWorkType es MULTIPLE_CHOICE_QUESTION.

RubricGrade

Una calificación de 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. ID del criterio.
levelId

string

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

number

Opcional. Son puntos opcionales asignados para este criterio, que suelen basarse en el nivel. Los niveles pueden tener o no puntos. Si no se establece, significa que 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 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 los archivos adjuntos solo se propagan si el usuario solicitante 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.

Archivo adjunto

Se agregó un archivo adjunto a la tarea del estudiante.

Cuando creas archivos adjuntos, no se admite configurar el 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)

Archivo de video de YouTube adjunto.
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 de un estudiante a una pregunta de respuesta corta.

MultipleChoiceSubmission

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

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

string

Es la opción de selección del estudiante.

SubmissionHistory

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

object (StateHistory)

La información del historial de estado del envío, 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 se encuentra 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)

Cuándo el envío entró en este estado

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 el 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 mostrarse este valor.
CREATED Se creó el envío.
TURNED_IN El estudiante entregó un documento asignado, que puede ser o no una plantilla.
RETURNED El profesor le devolvió el documento asignado al estudiante.
RECLAIMED_BY_STUDENT El estudiante entregó el documento asignado y, luego, eligió "anular la entrega", lo que le permitió volver a controlar la tarea como propietario.
STUDENT_EDITED_AFTER_TURN_IN El estudiante editó su entrega después de enviarla. Actualmente, solo lo usan las preguntas, cuando el estudiante edita su respuesta.

GradeHistory

El 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 en el historial de calificaciones de la entrega.
maxPoints

number

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

string (Timestamp format)

Cuándo se cambió la calificación del envío.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 realizó el cambio de calificación
gradeChangeType

enum (GradeChangeType)

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

GradeChangeType

Posibles tipos de cambios de calificación

Enumeraciones
UNKNOWN_GRADE_CHANGE_TYPE No se especificó ningún tipo de cambio de calificación. Nunca debería mostrarse este valor.
DRAFT_GRADE_POINTS_EARNED_CHANGE Un cambio en el numerador de la calificación del borrador.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Un cambio en el numerador de la calificación asignada.
MAX_POINTS_CHANGE Un cambio en el denominador de la calificación

Métodos

get

 Muestra una 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 una entrega de un estudiante.

reclaim

 Reclama una entrega de un estudiante en nombre del estudiante que es el propietario.

return

 Muestra una entrega de un estudiante.

turnIn

 Entrega una entrega de estudiante.