REST Resource: courses.courseWork

Recurso: CourseWork

Trabajo del curso creado por un profesor para los alumnos 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 en cada 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 del trabajo del curso. Si se configura, la descripción debe ser una string UTF-8 válida que contenga 30,000 caracteres como máximo.

materials[]

object (Material)

Materiales adicionales

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

state

enum (CourseWorkState)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 en este trabajo del curso.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 envío de este trabajo del curso. Se debe especificar si se especifica dueTime.

dueTime

object (TimeOfDay)

Es el momento opcional del día, en UTC, en el que vence la entrega de este trabajo del curso. Se debe especificar si se especifica dueDate.

scheduledTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 de trabajo del curso está asociado con el proyecto de Play Console que realiza la solicitud.

Consulta courseWork.create para obtener más detalles.

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)

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

submissionModificationMode

enum (SubmissionModificationMode)

Parámetro de configuración para determinar cuándo los alumnos 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

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

gradeCategory

object (GradeCategory)

La categoría a la que contribuye la calificación de este curso. Presenta solo cuando se elige 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 Para 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 de otra manera.

Estado del trabajodelcurso

Estados posibles del trabajo del curso.

Enumeradores
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Nunca se muestra.
PUBLISHED Estado del trabajo publicado 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 Estado del trabajo que se publicó, pero 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.

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

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

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

object (DriveFolder)

Carpeta de Drive donde se colocan los archivos adjuntos de las entregas de los alumnos. Solo se propaga para los profesores y administradores del curso.

Pregunta de opción múltiple

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 el 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 de cursos que el solicitante puede ver.

modifyAssignees

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

patch

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