REST Resource: courses.courseWork

Recurso: CourseWork

Trabalho do curso criado por um professor para os estudantes.

Representação 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

Identificador do curso.

Somente leitura.
id

string

Identificador atribuído pelo Google Sala de Aula para esta atividade, exclusivo por curso.

Somente leitura.
title

string

Título do trabalho do curso. O título precisa ser uma string UTF-8 válida com entre 1 e 3.000 caracteres.
description

string

Descrição opcional desta atividade. Se definido, a descrição precisa ser uma string UTF-8 válida com no máximo 30.000 caracteres.
materials[]

object (Material)

Materiais extras.

O CourseWork não pode ter mais de 20 itens de material.
state

enum (CourseWorkState)

Status desta atividade. Se não for especificado, o estado padrão será DRAFT.
creationTime

string (Timestamp format)

Carimbo de data/hora em que a atividade foi criada.

Somente leitura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Carimbo de data/hora da mudança mais recente neste trabalho do curso.

Somente leitura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
dueDate

object (Date)

Data opcional, em UTC, de entrega dos trabalhos deste curso. Precisa ser especificado se dueTime for especificado.
dueTime

object (TimeOfDay)

Horário opcional do dia, em UTC, em que as atividades deste curso devem ser entregues. Precisa ser especificado se dueDate for especificado.
scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional em que o trabalho será publicado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
maxPoints

number

Nota máxima para esta atividade. Se for zero ou não especificado, a atividade será considerada sem nota. Precisa ser um número inteiro não negativo.
workType

enum (CourseWorkType)

Tipo de atividade.

O tipo é definido quando o trabalho é criado e não pode ser alterado.
associatedWithDeveloper

boolean

Se este item de trabalho do curso está associado ao projeto do Developer Console que faz a solicitação.

Consulte courseWork.create para mais detalhes.

Somente leitura.
assigneeMode

enum (AssigneeMode)

Modo de atribuição do curso. Se não for especificado, o valor padrão será ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores dos estudantes com acesso ao curso. Esse campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se assigneeMode for INDIVIDUAL_STUDENTS, somente os estudantes especificados nesse campo vão receber a atividade.
submissionModificationMode

enum (SubmissionModificationMode)

Configuração para determinar quando os estudantes podem modificar os envios. Se não for especificado, o valor padrão será MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Identificador do usuário que criou a atividade.

Somente leitura.
topicId

string

Identificador do tema a que esta atividade está associada. Precisa corresponder a um tópico existente no curso.
gradeCategory

object (GradeCategory)

A categoria em que a nota deste trabalho escolar contribui. Presente somente quando uma categoria é escolhida para o trabalho escolar. Pode ser usado no cálculo da nota final.

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. A versão de prévia da API usada para recuperar este recurso.
Campo de união details. Detalhes adicionais específicos de um tipo de atividade. details pode ser apenas de um dos tipos a seguir:
assignment

object (Assignment)

Detalhes da atividade. Isso só será preenchido quando workType for ASSIGNMENT.

Somente leitura.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Detalhes da pergunta de múltipla escolha. Em operações de leitura, esse campo é preenchido apenas quando workType é MULTIPLE_CHOICE_QUESTION. Para operações de gravação, esse campo precisa ser especificado ao criar atividades com um workType de MULTIPLE_CHOICE_QUESTION e não pode ser definido de outra forma.
gradingPeriodId

string

Identificador do período de avaliação associado ao trabalho escolar.

  • Na criação, se não for especificado, o ID do período de avaliação será definido com base no dueDate (ou scheduledTime se nenhum dueDate estiver definido).
  • Para indicar que não há associação a nenhum período de avaliação, defina esse campo como uma string vazia ("").
  • Se especificado, ele precisa corresponder a um ID de período de avaliação existente no curso.

CourseWorkState

Possíveis estados de um trabalho do curso.

Tipos enumerados
COURSE_WORK_STATE_UNSPECIFIED Nenhum estado especificado. Esse valor nunca é retornado.
PUBLISHED Status do trabalho publicado. Esse é o estado padrão.
DRAFT Status de trabalhos que ainda não foram publicados. O trabalho nesse estado é visível apenas para professores do curso e administradores do domínio.
DELETED Status de um trabalho que foi publicado, mas agora está excluído. O trabalho nesse estado é visível apenas para professores do curso e administradores do domínio. O trabalho nesse estado é excluído após algum tempo.

SubmissionModificationMode

Possíveis modos de modificação para envios de estudantes.

Tipos enumerados
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nenhum modo de modificação especificado. Esse valor nunca é retornado.
MODIFIABLE_UNTIL_TURNED_IN Os envios podem ser modificados antes de serem entregues.
MODIFIABLE As inscrições podem ser modificadas a qualquer momento.

Atribuição

Mais detalhes sobre as atividades.

Representação JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Campos
studentWorkFolder

object (DriveFolder)

Pasta do Drive em que os anexos dos envios dos estudantes são colocados. Esse campo só é preenchido para professores e administradores do curso.

MultipleChoiceQuestion

Mais detalhes sobre perguntas de múltipla escolha.

Representação JSON 
{
  "choices": [
    string
  ]
}
Campos
choices[]

string

Opções possíveis.

Métodos

create

 Cria um trabalho do curso.

delete

 Exclui uma atividade.

get

 Retorna um trabalho do curso.

getAddOnContext

 Recebe metadados para complementos do Google Sala de Aula no contexto de uma postagem específica.

list

 Retorna uma lista de atividades que o solicitante tem permissão para visualizar.

modifyAssignees

 Modifica o modo de atribuição e as opções de um curso.

patch

 Atualiza um ou mais campos de uma atividade.