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)
  },

  // 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.
}
Campos
courseId

string

Es el identificador del curso.

Solo lectura.

id

string

Es el identificador asignado por Classroom del trabajo de este curso, único por curso.

Solo lectura.

title

string

Título del trabajo del curso. El título debe ser una string UTF-8 válida que contenga entre 1 y 3,000 caracteres.

description

string

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

materials[]

object (Material)

Materiales adicionales.

El trabajo del curso no debe tener más de 20 elementos materiales.

state

enum (CourseWorkState)

Estado del trabajo del curso Si no se especifica, el estado predeterminado es DRAFT.

creationTime

string (Timestamp format)

Marca de tiempo del momento en que se creó el trabajo del curso.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC "Zulú", 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)

Marca de tiempo del cambio más reciente que se realizó en el trabajo del curso.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

dueDate

object (Date)

Fecha opcional, en UTC, en la que vence el plazo de entrega de los trabajos del curso. Se debe especificar si se especifica dueTime.

dueTime

object (TimeOfDay)

Hora opcional del día, en UTC, en la que se debe enviar la entrega de este trabajo del curso. Se debe especificar si se especifica dueDate.

scheduledTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

maxPoints

number

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

workType

enum (CourseWorkType)

Tipo de este 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 Developer Console que realiza la solicitud.

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

Solo lectura.

assigneeMode

enum (AssigneeMode)

Modo de destinatario del trabajo del curso. Si no se especifica, el valor predeterminado es ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores de estudiantes con acceso al trabajo del curso Este campo solo se configura si assigneeMode es INDIVIDUAL_STUDENTS. Si la assigneeMode es INDIVIDUAL_STUDENTS, el trabajo del curso solo se asignará a los estudiantes especificados en este campo.

submissionModificationMode

enum (SubmissionModificationMode)

Parámetro de configuración que determina 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 del curso.

Solo lectura.

topicId

string

Identificador del tema con el que está asociado este trabajo de curso. Deben coincidir con un tema existente del curso.

gradeCategory

object (GradeCategory)

La categoría a la que contribuye la calificación de este trabajo. Presente solo cuando se haya elegido una categoría para el trabajo del curso. Se puede usar para calcular la calificación general.

Solo lectura.

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. Se propaga solo 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 debe especificarse cuando se crea el trabajo del curso con un workType de MULTIPLE_CHOICE_QUESTION y no se debe configurar de otra manera.

CourseWorkState

Posibles estados del trabajo del curso

Enumeradores
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Este nunca se muestra.
PUBLISHED Estado del trabajo publicado Este es el estado predeterminado.
DRAFT Estado del trabajo que aún no se publicó. Solo los profesores del curso y los administradores del dominio pueden ver el trabajo en este estado.
DELETED 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.

Enumeradores
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED No se especificó ningún modo de modificación. Este 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.

Assignment

Detalles adicionales de las asignaciones.

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

object (DriveFolder)

Carpeta de Drive donde se guardan los archivos adjuntos de las entregas de 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 el trabajo del curso.

delete

Borra un trabajo del curso.

get

Muestra el trabajo del curso.

getAddOnContext

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

list

Muestra una lista de trabajos del curso que el solicitante puede ver.

modifyAssignees

Modifica el modo de destinatario y las opciones de un trabajo del curso.

patch

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