REST Resource: courses.courseWork

Recurso: CourseWork

Es el trabajo de clase que crea 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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Campos
courseId

string

Es el identificador del curso.

Solo lectura.
id

string

Es el identificador asignado por Classroom para este trabajo en clase, único por curso.

Solo lectura.
title

string

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

string

Descripción opcional de esta tarea. Si se establece, 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

El trabajo de clase no debe tener más de 20 elementos de material.
state

enum (CourseWorkState)

Estado de este trabajo en clase. 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 en clase.

Solo lectura.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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 en clase.

Solo lectura.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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 vencen los envíos de esta tarea. Se debe especificar si se especifica dueTime.
dueTime

object (TimeOfDay)

Hora del día opcional, en UTC, en la que vencen los envíos de este trabajo en clase. Se debe especificar si se especifica dueDate.
scheduledTime

string (Timestamp format)

Marca de tiempo opcional que indica cuándo se programará la publicación de esta tarea.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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 esta tarea. Si es cero o no se especifica, se considera que la tarea no tiene calificación. Debe ser un valor entero no negativo.
workType

enum (CourseWorkType)

Es el tipo de este trabajo en clase.

El tipo se establece cuando se crea el trabajo de clase y no se puede cambiar.
associatedWithDeveloper

boolean

Indica si esta tarea está asociada 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 trabajo en clase. Si no se especifica, el valor predeterminado es ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

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

enum (SubmissionModificationMode)

Es el parámetro de configuración para determinar cuándo los estudiantes pueden modificar las entregas. Si no se especifica, el valor predeterminado es MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Es el identificador del usuario que creó el trabajo de clase.

Solo lectura.
topicId

string

Identificador del tema con el que se asocia este trabajo en clase. 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 en clase. Solo está presente cuando se elige una categoría para el trabajo en clase. 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 usa para recuperar este recurso.
learningGoals[]

object (LearningGoal)

Opcional.

Son referencias a los objetivos de aprendizaje adjuntos a este trabajo en clase. CourseWork puede tener un máximo de 10 objetivos de aprendizaje. Este campo solo se completa si se establece el previewVersion adecuado.
Son detalles adicionales específicos de un tipo de tarea. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
assignment

object (Assignment)

Detalles de la asignación. Este campo solo se propaga cuando workType es ASSIGNMENT.

Solo lectura.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

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. En el caso de las operaciones de escritura, este campo se debe especificar cuando se crea un trabajo de clase con un workType de MULTIPLE_CHOICE_QUESTION y no se debe establecer de otra manera.
Fin de los campos mutuamente excluyentes.
gradingPeriodId

string

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

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

CourseWorkState

Son los estados posibles de las tareas.

Enums
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Nunca se devuelve.
PUBLISHED Es el estado del trabajo que se publicó. Este es el estado predeterminado.
DRAFT 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 de las obras que se publicaron, pero que ahora se borraron. 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 las entregas de los estudiantes.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED No se especificó ningún modo de modificación. Nunca se devuelve.
MODIFIABLE_UNTIL_TURNED_IN Los envíos se pueden modificar antes de entregarlos.
MODIFIABLE Los envíos se pueden modificar en cualquier momento.

Asignación

Detalles adicionales de las asignaciones.

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 profesores y administradores del curso.

MultipleChoiceQuestion

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

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

string

Opciones posibles.

Métodos

create

 Crea trabajo en clase.

delete

 Borra un trabajo de clase.

get

 Devuelve el trabajo en clase.

getAddOnContext

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

list

 Devuelve una lista de tareas que el solicitante tiene permiso para ver.

modifyAssignees

 Modifica el modo de destinatario y las opciones de un trabajo en clase.

patch

 Actualiza uno o más campos de una tarea.