REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Entrega de los estudiantes para el trabajo del curso.

Se generan StudentSubmission elementos cuando se crea un elemento CourseWork.

Es posible que las entregas de los estudiantes a las que nunca se haya accedido (es decir, con state = NEW) no tengan una hora de creación o 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

Identificador del trabajo del curso al que corresponde.

Solo lectura.
id

string

Es el identificador asignado por Classroom para la entrega del estudiante. Esto es único entre las entregas 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)

Hora de creación de este envío. Esta opción puede desactivarse 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)

Fecha de la última actualización de este envío. Esta opción puede desactivarse 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

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, números no 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, números no enteros), pero se redondean a dos decimales.

Solo los profesores del curso pueden modificar esto.
rubricId

string

Solo salida. Identificador de la rúbrica que se encuentra 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 rúbrica. Este ID refleja la rúbrica activa en este momento. por lo que cambia si los profesores borran las rúbricas y las vuelven a crear.

Solo lectura.

draftRubricGrades

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

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

Este mapa estará vacío si no hay una rúbrica adjunta al trabajo de este 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 establecidas. 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 en función de sus criterios.

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 han establecido calificaciones en ninguno de los criterios. Las entradas solo se propagan para las calificaciones establecidas. 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 al que corresponde esta entrega.

Solo lectura.
associatedWithDeveloper

boolean

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 las entregas (incluye los historiales de estado y de calificaciones).

Solo lectura.
previewVersion

enum (PreviewVersion)

Solo salida. La versión preliminar de la API. Esto se debe establecer para acceder a las nuevas capacidades 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)

Envía contenido cuando CourseWorkType sea ASSIGNMENT.

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

object (ShortAnswerSubmission)

Envía contenido cuando CourseWorkType sea SHORT_ANSWER_QUESTION
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Envía contenido cuando CourseWorkType sea MULTIPLE_CHOICE_QUESTION.

RubricGrade

Es la calificación de una rúbrica establecida para la entrega 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 de criterio
levelId

string

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

number

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

AssignmentSubmission

Trabajo de los estudiantes en una tarea

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

object (Attachment)

Archivos adjuntos que agregó el estudiante. Si el estudiante no accedió a la tarea en Classroom, es posible que aún no existan archivos de Drive que correspondan a materiales con un modo de uso compartido de STUDENT_COPY.

Algunos metadatos de los archivos adjuntos solo se propagan si el usuario solicitante tiene permiso para acceder a ellos. Los campos Identifier y anotherLink están siempre disponibles, pero es posible que otros (por ejemplo, title) no lo estén.

Archivo adjunto

Se agregó el archivo adjunto al trabajo de las tareas del estudiante.

Al crear 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)

Archivo adjunto de video de YouTube.
form

object (Form)

Archivo adjunto de Formularios de Google.

ShortAnswerSubmission

Trabajo del estudiante para una pregunta de respuesta corta.

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

string

Respuesta del estudiante a una pregunta de respuesta corta.

MultipleChoiceSubmission

Trabajo de los estudiantes para una pregunta de opción múltiple.

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

string

Opción seleccionada 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. 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 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 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)

Es la fecha en la que el envío ingresó a 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 en los que se encuentra un envío.

Enumeraciones
STATE_UNSPECIFIED No se especificó ningún estado. Nunca debe mostrarse.
CREATED Se ha creado el envío.
TURNED_IN El alumno entregó un documento asignado, que puede o no ser una plantilla.
RETURNED El profesor le devolvió el documento asignado al alumno.
RECLAIMED_BY_STUDENT El alumno entregó el documento asignado y, luego, decidió "anular la entrega". la tarea, lo que le dará al alumno el control nuevamente como el propietario.
STUDENT_EDITED_AFTER_TURN_IN El estudiante editó su entrega después de entregarla. Actualmente, esta función solo se usa en las preguntas, cuando el estudiante 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 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)

El tipo de cambio de calificación en este momento en el historial de calificaciones de entregas.

GradeChangeType

Posibles tipos de cambio de calificación.

Enumeraciones
UNKNOWN_GRADE_CHANGE_TYPE No se especificó ningún tipo de cambio de calificación. Nunca debe mostrarse.
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

 Devuelve la entrega de un estudiante.

list

 Devuelve una lista de las entregas de los estudiantes que el solicitante tiene permitido 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 estudiante.

reclaim

 Reclamar una entrega de un estudiante en nombre del estudiante propietario

return

 Devuelve la entrega de un estudiante.

turnIn

 Entrega una entrega de un estudiante.