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 un identificador único por curso que asigna el aula del trabajo de este curso.

Solo lectura.

title

string

Título del trabajo de este 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 del trabajo de este curso. Si se configura, la descripción debe ser una string UTF-8 válida que contenga no 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)

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

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 el trabajo de este 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, de las entregas de este trabajo del curso. Esto debe especificarse si se especifica dueTime.

dueTime

object (TimeOfDay)

Hora del día opcional, en UTC, es la hora límite a la que se deben enviar las postulaciones para este trabajo del curso. Esto debe especificarse 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 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 el trabajo de este 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 de este curso.

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

associatedWithDeveloper

boolean

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 información.

Solo lectura.

assigneeMode

enum (AssigneeMode)

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

individualStudentsOptions

object (IndividualStudentsOptions)

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

submissionModificationMode

enum (SubmissionModificationMode)

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

Identificador del usuario que creó el trabajo del curso.

Solo lectura.

topicId

string

Es el identificador del tema asociado con este trabajo de curso. Debe coincidir con un tema existente del curso.

gradeCategory

object (GradeCategory)

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

Solo lectura.

previewVersion

enum (PreviewVersion)

Solo salida. La versión preliminar de la API que se usa para recuperar este recurso.

Campo de unión details. Detalles adicionales que son 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 asignación. Solo se propaga 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 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

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

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

CourseWorkState

Posibles estados del trabajo del curso.

Enumeradores
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Nunca se devuelve.
PUBLISHED 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 Estado de los trabajos 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

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

Assignment

Detalles adicionales sobre las tareas.

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 de 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 de un curso.

get

Devuelve el trabajo del curso.

getAddOnContext

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

list

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

modifyAssignees

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

patch

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