REST Resource: courses.courseWork

Recurso: CourseWork

Trabajo del curso creado por un profesor para los estudiantes del curso.

Representación JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
Campos
courseId

string

Es el identificador del curso.

Solo lectura.
id

string

Es el identificador asignado por Classroom para este trabajo del curso, que es único por curso.

Solo lectura.
title

string

Es el título de este trabajo del curso. El título debe ser una cadena UTF-8 válida que contenga entre 1 y 3,000 caracteres.
description

string

Es la descripción opcional de este trabajo del curso. Si se configura, la descripción debe ser una cadena UTF-8 válida que no contenga más de 30,000 caracteres.
materials[]

object (Material)

Materiales adicionales

CourseWork no debe tener más de 20 elementos de material.
state

enum (CourseWorkState)

Es el estado de este trabajo del curso. Si no se especifica, el estado predeterminado es DRAFT.
creationTime

string (Timestamp format)

Es la marca de tiempo de la creación de este trabajo del curso.

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)

Es la marca de tiempo del cambio más reciente en este trabajo del curso.

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".
dueDate

object (Date)

Fecha opcional, en UTC, en la que se deben entregar los trabajos de este curso. Se debe especificar si se especifica dueTime.
dueTime

object (TimeOfDay)

Es la hora del día opcional, en UTC, en la que se deben entregar los trabajos de este curso. Se debe especificar si se especifica dueDate.
scheduledTime

string (Timestamp format)

Es la marca de tiempo opcional en la que se programó la publicación de este trabajo del curso.

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".
maxPoints

number

Es la calificación máxima para este trabajo del curso. Si es cero o no se especifica, se considera que la tarea no se calificó. Debe ser un valor entero no negativo.
workType

enum (CourseWorkType)

Es el tipo de trabajo del curso.

El tipo se establece cuando se crea el trabajo del curso y no se puede cambiar.
associatedWithDeveloper

boolean

Indica si este elemento de trabajo del curso está asociado con el proyecto de la consola para desarrolladores que realiza la solicitud.

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

Solo lectura.
assigneeMode

enum (AssigneeMode)

Es el modo de asignación del curso. Si no se especifica, el valor predeterminado es ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Son los identificadores de los estudiantes que tienen acceso al curso. Este campo solo se establece si assigneeMode es INDIVIDUAL_STUDENTS. Si assigneeMode es INDIVIDUAL_STUDENTS, solo a los estudiantes especificados en este campo se les asignará el trabajo del curso.
submissionModificationMode

enum (SubmissionModificationMode)

Parámetro de configuración para determinar cuándo se permite a los estudiantes modificar los trabajos entregados. Si no se especifica, el valor predeterminado es MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Es el identificador del usuario que creó el curso.

Solo lectura.
topicId

string

Es el identificador del tema con el que se asocia este trabajo del curso. Debe coincidir con un tema existente en el curso.
gradeCategory

object (GradeCategory)

Es la categoría a la que contribuye la calificación de este trabajo del curso. Solo está presente cuando se elige una categoría para el curso. Se puede usar para calcular la calificación general.

Solo lectura.
previewVersion

enum (PreviewVersion)

Solo salida. Es la versión preliminar de la API que se usó para recuperar este recurso.
Campo de unión details. Son detalles adicionales específicos de un tipo de trabajo del curso. Las direcciones (details) solo pueden ser una de las siguientes opciones:
assignment

object (Assignment)

Son los detalles de la tarea. Este campo solo se propaga cuando workType es ASSIGNMENT.

Solo lectura.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Son los detalles de la pregunta de opción múltiple. En el caso de las operaciones de lectura, este campo solo se propaga cuando workType es MULTIPLE_CHOICE_QUESTION. Para las operaciones de escritura, este campo se debe especificar cuando se crea un trabajo del curso con un workType de MULTIPLE_CHOICE_QUESTION y no se debe establecer en ningún otro caso.
gradingPeriodId

string

Es el identificador del período de calificación asociado con el trabajo del curso.

  • En el momento de la creación, si no se especifica, el ID del período de calificación se establecerá según el dueDate (o scheduledTime si no se establece ningún dueDate).
  • Para indicar que no hay asociación con ningún período de calificación, establece este campo como una cadena vacía ("").
  • Si se especifica, debe coincidir con un ID de período de calificación existente en el curso.

CourseWorkState

Son los estados posibles del trabajo del curso.

Enumeraciones
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Este valor nunca se devuelve.
PUBLISHED Es el estado del trabajo que se publicó. Este es el estado predeterminado.
DRAFT Es el estado del trabajo que aún no se publicó. El trabajo en este estado solo es visible para los profesores del curso y los administradores del dominio.
DELETED Es el estado del trabajo que se publicó, pero que ahora se borró. El trabajo en este estado solo es visible para los profesores del curso y los administradores del dominio. El trabajo en este estado se borra después de un tiempo.

SubmissionModificationMode

Son los posibles modos de modificación para los envíos de los estudiantes.

Enumeraciones
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED No se especificó el modo de modificación. Este valor nunca se devuelve.
MODIFIABLE_UNTIL_TURNED_IN Las tareas se pueden modificar antes de entregarlas.
MODIFIABLE Las presentaciones se pueden modificar en cualquier momento.

Asignación

Son detalles adicionales de las tareas.

Representación JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Campos
studentWorkFolder

object (DriveFolder)

Es la carpeta de Drive en la que se colocan los archivos adjuntos de las entregas de los estudiantes. Este campo solo se completa para los administradores y profesores del curso.

MultipleChoiceQuestion

Son detalles adicionales para las preguntas de opción múltiple.

Representación JSON 
{
  "choices": [
    string
  ]
}
Campos
choices[]

string

Son las opciones posibles.

Métodos

create

 Crea tareas del curso.

delete

 Borra un trabajo del curso.

get

 Devuelve el trabajo del curso.

getAddOnContext

 Obtiene metadatos para los complementos de Classroom en el contexto de una publicación específica.

list

 Devuelve una lista de los trabajos del curso que el solicitante tiene permiso para ver.

modifyAssignees

 Modifica el modo y las opciones de asignación de un curso.

patch

 Actualiza uno o más campos de un trabajo del curso.