Are your users using Classroom with Google Meet? Check out the Apps Script quickstart covering how to check student attendance in Google Meet courses.

REST Resource: courses.courseWork

Recurso: trabajo de curso

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

Identificador del curso.

Solo lectura.

id

string

Identificador asignado por el aula de este trabajo de curso, único por curso.

Solo lectura.

title

string

Título de este trabajo de curso. El título debe ser una cadena UTF-8 válida que contenga entre 1 y 3000 caracteres.

description

string

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

CourseWork no debe tener más de 20 elementos materiales.

state

enum ( CourseWorkState )

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

creationTime

string ( Timestamp format)

Marca de tiempo cuando se creó este trabajo de curso.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC "Zulu", 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 en este trabajo del curso.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC "Zulu", 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 vencen las entregas para este trabajo del curso. Esto debe especificarse si se especifica dueTime .

dueTime

object ( TimeOfDay )

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

scheduledTime

string ( Timestamp format)

Marca de tiempo opcional cuando se programó la publicación de este trabajo de curso.

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

Nota máxima para este trabajo de curso. Si es cero o no se especifica, esta tarea se considera sin calificación. Debe ser un valor 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 Developer Console que realiza la solicitud.

Consulte courseWork.create para obtener más detalles.

Solo lectura.

assigneeMode

enum ( AssigneeMode )

Asignatario modo de los cursos. Si no se especifica, el valor predeterminado es ALL_STUDENTS .

individualStudentsOptions

object ( IndividualStudentsOptions )

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

submissionModificationMode

enum ( SubmissionModificationMode )

Configuración para determinar 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

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

gradeCategory

object ( GradeCategory )

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

Solo lectura.

details del campo de unión. Detalles adicionales que son específicos de un tipo de trabajo de curso. Los details pueden ser solo uno de los siguientes:
assignment

object ( Assignment )

Detalles de la asignación. Esto se completa solo cuando workType es ASSIGNMENT .

Solo lectura.

multipleChoiceQuestion

object ( MultipleChoiceQuestion )

Detalles de la pregunta de opción múltiple. Para operaciones de lectura, este campo se completa solo cuando workType es MULTIPLE_CHOICE_QUESTION . Para las operaciones de escritura, este campo debe especificarse al crear el trabajo del curso con un workType de trabajo de MULTIPLE_CHOICE_QUESTION y no debe establecerse de otra manera.

CourseWorkState

Posibles estados de funcionamiento del curso.

Enumeraciones
COURSE_WORK_STATE_UNSPECIFIED No se especifica el estado. Esto nunca se devuelve.
PUBLISHED Estado del trabajo que ha sido publicado. Este es el estado predeterminado.
DRAFT Estado del trabajo que aún no se ha publicado. 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 que ahora se eliminó. El trabajo en este estado solo es visible para los profesores del curso y los administradores del dominio. El trabajo en este estado se elimina después de un tiempo.

Fecha

Representa una fecha de calendario total 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 es relativa al calendario gregoriano. Esto puede representar uno de los siguientes:

  • 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 cero (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

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

integer

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

month

integer

Mes de un año. Debe ser de 1 a 12, o 0 para especificar un año sin mes ni día.

day

integer

Día de un mes. Debe ser del 1 al 31 y válido para el año y el mes, o 0 para especificar un año por sí solo o un año y un mes donde el día no es significativo.

horadeldía

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 de 0 a 23. Una API puede optar por permitir el valor "24:00:00" para escenarios como la hora de cierre comercial.

minutes

integer

Minutos de la hora del día. Debe ser de 0 a 59.

seconds

integer

Segundos de minutos del tiempo. Normalmente debe ser de 0 a 59. Una API puede permitir el valor 60 si permite segundos intercalares.

nanos

integer

Fracciones de segundo en nanosegundos. Debe ser de 0 a 999,999,999.

SubmissionModificationModeSubmissionModificationMode

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

Enumeraciones
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED No se especifica el modo de modificación. Esto nunca se devuelve.
MODIFIABLE_UNTIL_TURNED_IN Los envíos se pueden modificar antes de ser entregados.
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 estudiantes. Esto solo se completa para los 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 trabajo de curso.

delete

Elimina un trabajo de curso.

get

Devuelve el trabajo del curso.

list

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

modifyAssignees

Modifica el modo de asignación y las opciones de un curso.

patch

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