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 a esta tarea del curso, único para cada 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

Descripción opcional de este trabajo del curso. 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

La carga lectiva no debe tener más de 20 elementos de material.
state

enum (CourseWorkState)

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

string (Timestamp format)

Marca de tiempo de la creación de este trabajo del curso.

Solo lectura.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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 RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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 las entregas de este trabajo del curso. Esto se debe especificar si se especifica dueTime.
dueTime

object (TimeOfDay)

Hora del día opcional, en UTC, en la que vencen las entregas de este trabajo del curso. Esto se debe especificar si se especifica dueDate.
scheduledTime

string (Timestamp format)

Es una marca de tiempo opcional para la fecha de publicación programada de este trabajo del curso.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maxPoints

number

Calificación máxima para este trabajo del curso. Si es cero o no se especifica, esta tarea se considerará sin calificar. Debe ser un número entero no negativo.
workType

enum (CourseWorkType)

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 del trabajo del curso está asociado con el proyecto de Play Console que realiza la solicitud.

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

Solo lectura.
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

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 se asignará el curso a los estudiantes especificados en este campo.
submissionModificationMode

enum (SubmissionModificationMode)

Establece 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 curso.

Solo lectura.
topicId

string

Es el identificador del tema con el que está asociado 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 esta tarea. Solo se muestra 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.
Campo de unión details. 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)

Detalles de la tarea. 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 se propaga solo cuando workType es MULTIPLE_CHOICE_QUESTION. Para las operaciones de escritura, este campo se debe especificar cuando se crea el trabajo del curso con un workType de MULTIPLE_CHOICE_QUESTION y no se debe configurar de otra manera.
gradingPeriodId

string

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

  • Durante la creación, si no se especifica, el ID del período de calificación se establecerá en función de dueDate (o scheduledTime si no se establece 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

Estados posibles de la tarea del curso.

Enumeraciones
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Este valor nunca se muestra.
PUBLISHED Es el estado de la obra que se publicó. Este es el estado predeterminado.
DRAFT Es el estado de los trabajos que aún no se publican. Solo los profesores del curso y los administradores del dominio pueden ver el trabajo en este estado.
DELETED Es el estado del trabajo que se publicó, pero que ahora se borró. Solo los profesores del curso y los administradores del dominio pueden ver el trabajo en este estado. El trabajo en este estado se borra después de un tiempo.

SubmissionModificationMode

Posibles modos de modificación para las entregas de los estudiantes.

Enumeraciones
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED No se especificó ningún modo de modificación. Este valor nunca se muestra.
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 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 tareas que envían los estudiantes. 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 trabajos del curso.

delete

 Borra el trabajo de un curso.

get

 Muestra el trabajo del curso.

getAddOnContext

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

list

 Muestra una lista del trabajo del curso que el solicitante puede ver.

modifyAssignees

 Modifica el modo de asignación y las opciones de una tarea del curso.

patch

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