REST Resource: courses.courseWork

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Recurso: CourseWork

Trabajo de 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 el aula de este trabajo del curso, único por curso.

Solo lectura

title

string

Título del trabajo de este 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 de este curso. Si se establece, 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 curso debe tener un máximo de 20 elementos.

state

enum (CourseWorkState)

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

creationTime

string (Timestamp format)

Es la marca de tiempo de la creación del trabajo de este curso.

Solo lectura

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos decimales. 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 resolución de nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

dueDate

object (Date)

La fecha opcional en UTC es la de que se deben entregar los trabajos de este curso. Esto se debe especificar si se especifica dueTime.

dueTime

object (TimeOfDay)

Es la hora opcional del día, en UTC, en la que se deben entregar los trabajos de este curso. Esto se debe especificar si se especifica dueDate.

scheduledTime

string (Timestamp format)

Es una marca de tiempo opcional en la que se programó la publicación del trabajo de este curso.

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

maxPoints

number

Calificación máxima de este trabajo del curso. Si no se especifica ninguna, esta tarea se considerará sin calificar. Debe ser un valor 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 Developer Console que realiza la solicitud.

Consulta courseWork.create para obtener más detalles.

Solo lectura

assigneeMode

enum (AssigneeMode)

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

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores de los alumnos con acceso al trabajo del curso. Este campo se establece solo si assigneeMode es INDIVIDUAL_STUDENTS. Si el assigneeMode es INDIVIDUAL_STUDENTS, solo se asigna el trabajo del curso a los alumnos especificados en este campo.

submissionModificationMode

enum (SubmissionModificationMode)

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 está asociado este trabajo de curso. Debe coincidir con un tema existente del curso.

gradeCategory

object (GradeCategory)

Indica la categoría a la que contribuye la calificación de este curso. Solo se muestra 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. Son detalles adicionales específicos de cada tipo de trabajo del curso. Las direcciones (details) solo pueden ser una de las siguientes opciones:
assignment

object (Assignment)

Detalles de la tarea. Esto 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 el trabajo de curso con un workType de MULTIPLE_CHOICE_QUESTION y no se debe configurar de otra manera.

Estado del trabajo del curso

Posibles estados del trabajo.

Enumeradores
COURSE_WORK_STATE_UNSPECIFIED No se especificó ningún estado. Nunca se muestra.
PUBLISHED Estado del trabajo que se publicó Este es el estado predeterminado.
DRAFT Estado de los trabajos que aún no se publicaron. Solo los profesores y 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 y administradores del dominio pueden ver el trabajo en este estado. El trabajo en este estado se borra después de un tiempo.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Esto puede representar uno de los siguientes aspectos:

  • Una fecha completa con valores de año, mes y día distintos de cero
  • Un mes y un día con un año en cero (por ejemplo, un aniversario).
  • Un año solo con un mes en cero y un día cero
  • Un año y un mes, con un día de cero (por ejemplo, una fecha de vencimiento de la tarjeta de crédito).

Tipos relacionados:

Representación JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe encontrarse entre 1 y 9999, o 0 para especificar una fecha sin año.

month

integer

Mes del año Debe encontrarse entre 1 y 12, o 0 para especificar un año sin mes ni día.

day

integer

Día del mes Debe encontrarse entre 1 y 31 y ser válido para el mes del año, o bien debe ser 0 para especificar un año por su cuenta o un año y un mes en los que el día no es importante.

TimeOfDay

Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos bisiestos. Los tipos relacionados son google.type.Date y google.protobuf.Timestamp.

Representación JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas del día en formato de 24 horas. Debe ser del 0 al 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.

minutes

integer

Minutos de horas del día. Debe ser un valor entre 0 y 59.

seconds

integer

Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59. Una API puede permitir el valor 60 si permite segundos bisiestos.

nanos

integer

Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999.

Modo de modificación de envío

Posibles modos de modificación de 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 la entrega.
MODIFIABLE Los envíos pueden modificarse en cualquier momento.

Asignación

Detalles adicionales para las tareas.

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

object (DriveFolder)

Carpeta de Drive en la que se guardan los archivos adjuntos de los alumnos. Solo se propaga para profesores y administradores del curso.

Pregunta de opción múltiple

Detalles adicionales para 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.

list

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

modifyAssignees

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

patch

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