¿Tus usuarios usan Classroom con Google Meet? Consulta la guía de inicio rápido de Apps Script, en la que se explica cómo comprobar la asistencia de los alumnos en los cursos de Google Meet.

REST Resource: courses.courseWork.studentSubmissions

Recurso: StudentSubmission

Entrega de trabajos del curso por parte del alumno.

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

Es posible que las entregas de StudentSubmissions a las 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,
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],

  // 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

Identificador del curso.

Solo lectura.
courseWorkId

string

Es el identificador del trabajo del curso al que corresponde.

Solo lectura.
id

string

Identificador asignado por Classroom para la entrega de los alumnos. Esto es único entre las entregas de trabajos relevantes del curso.

Solo lectura.
userId

string

Es el identificador del alumno propietario de esta entrega.

Solo lectura.
creationTime

string (Timestamp format)

Hora de creación de este envío. Esto se puede desactivar si el alumno no accedió a este elemento.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC & Zulu, 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)

Fecha de la última actualización de este envío Esto se puede desactivar si el alumno no accedió a este elemento.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC & Zulu, 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 este envío.

Solo lectura.
late

boolean

Indica si este envío está retrasado.

Solo lectura.
draftGrade

number

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

Solo los profesores del curso pueden verlo y modificarlo.
assignedGrade

number

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

Solo los profesores del curso pueden modificar esta opción.
courseWorkType

enum (CourseWorkType)

Indica el tipo de trabajo del curso al que se orienta esta entrega.

Solo lectura.
associatedWithDeveloper

boolean

Si este envío de alumnos está asociado al proyecto de la Consola para programadores que realiza la solicitud

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

Solo lectura.
submissionHistory[]

object (SubmissionHistory)

El historial del envío (incluye el estado y el historial de calificaciones).

Solo lectura.
Campo de unión content. Contenido de 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ío de contenido cuando coursesWorkType es ASSIGNMENT.

Los alumnos pueden modificar el contenido con studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Envío de contenido cuando coursesWorkType es SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

El contenido enviado cuando cursoWorkType es MULTIPLE_CHOICE_QUESTION.

Estado del envío

Estados posibles de las entregas de los alumnos.

Enumeradores
SUBMISSION_STATE_UNSPECIFIED No se especificó ningún estado. No se debería mostrar nunca.
NEW El alumno nunca accedió a este envío. No se muestran archivos adjuntos ni se establecen marcas de tiempo.
CREATED Se creó.
TURNED_IN Se entregó al profesor.
RETURNED Se devolvió el alumno.
RECLAIMED_BY_STUDENT El alumno decidió no entregar la tarea.

Tarea

Trabajo del alumno para una tarea.

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

object (Attachment)

Archivos adjuntos agregados por el alumno. Es posible que aún no existan los archivos de Drive que correspondan a materiales con un modo de uso compartido de STUDENT_COPY si el alumno no accedió a la tarea en Classroom.

Algunos metadatos de archivos adjuntos solo se propagan si el usuario que lo solicita tiene permiso para acceder a ellos. Los campos Identifier y alternateLink siempre están disponibles, pero otros (por ejemplo, el título) no lo están.

Adjunto

Se agregó el archivo adjunto al trabajo de la tarea del alumno.

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)

Archivo adjunto de video de YouTube.
form

object (Form)

Archivo adjunto de Formularios de Google.

Envío de respuestas corta

El trabajo del alumno para una pregunta de respuesta corta.

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

string

Respuesta de los alumnos a una pregunta de respuesta corta.

Envío de varias opciones

Trabajo del alumno para una pregunta de opción múltiple.

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

string

Elección de los alumnos.

Historial de envíos

El historial del envío. Actualmente, se incluyen historiales 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. El tipo de SubmissionHistory puede ser StateState, GradeHistory. Las direcciones (type) solo pueden ser una de las siguientes opciones:
stateHistory

object (StateHistory)

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

object (GradeHistory)

Es la información del historial de calificaciones de la tarea, si está presente.

Historial del estado

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)

Cuando el envío ingresó a este estado.

Una marca de tiempo en formato RFC3339 UTC & Zulu, 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

Es el profesor o alumno que realizó el cambio.

State

Estados posibles para un envío.

Enumeradores
STATE_UNSPECIFIED No se especificó ningún estado. No se debería mostrar nunca.
CREATED Se creó 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ó cancelar la entrega, lo que le dio nuevamente el control como propietario.
STUDENT_EDITED_AFTER_TURN_IN El alumno editó su entrega después de entregarla. Actualmente, solo pueden utilizarla las preguntas, cuando el alumno edita la respuesta.

Historial de calificaciones

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 del historial de calificaciones enviadas
maxPoints

number

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

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC & Zulu, 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 cambio de calificaciones que hay actualmente en el historial de calificaciones enviadas

TipoDeCambioDeCalificación

Los posibles tipos de cambio de calificación.

Enumeradores
UNKNOWN_GRADE_CHANGE_TYPE No se especificó ningún tipo de cambio de calificación. No se debería mostrar nunca.
DRAFT_GRADE_POINTS_EARNED_CHANGE Un cambio en el numerador de la calificación preliminar
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 la entrega de un alumno.

list

 Muestra una lista de las entregas de los alumnos que el solicitante puede ver y considera los alcances de OAuth de la solicitud.

modifyAttachments

 Modificar los archivos adjuntos de la entrega de los alumnos

patch

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

reclaim

 Reclama un trabajo entregado por un alumno en nombre del alumno que lo posee.

return

 Muestra la entrega de un alumno.

turnIn

 Entrega una entrega de alumno.