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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "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 1 a 3.000 caracteres.
description

string

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

object (Material)

Materiais adicionais.

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 de quando 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 nesta atividade.

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, em que os envios para este trabalho do curso devem ser feitos. Isso precisa ser especificado se dueTime for especificado.
dueTime

object (TimeOfDay)

Hora do dia opcional, em UTC, em que as entregas para esta atividade do curso devem ser feitas. Isso precisa ser especificado se dueDate for especificado.
scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional de quando a atividade será publicada.

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 do curso. Se for zero ou não for especificado, a atividade será considerada sem nota. Precisa ser um número inteiro não negativo.
workType

enum (CourseWorkType)

Tipo de atividade do curso.

O tipo é definido quando a atividade é criada e não pode ser alterado.
associatedWithDeveloper

boolean

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

Consulte courseWork.create para mais detalhes.

Somente leitura.
assigneeMode

enum (AssigneeMode)

Modo de atribuição da atividade. Se o valor não for especificado, será usado o padrão ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores de estudantes com acesso às atividades. Esse campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se o assigneeMode for INDIVIDUAL_STUDENTS, apenas 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 o valor não for especificado, será usado o padrão MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Identificador do usuário que criou a atividade.

Somente leitura.
topicId

string

Identificador do tópico associado a esta atividade. Precisa corresponder a um tópico que já existe no curso.
gradeCategory

object (GradeCategory)

A categoria em que a nota da atividade será incluída. Presente apenas quando uma categoria é escolhida para a atividade. Pode ser usado no cálculo da nota final.

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. A versão de pré-lançamento da API usada para recuperar esse recurso.
learningGoals[]

object (LearningGoal)

Opcional.

Referências a metas de aprendizado anexadas a esta atividade. O CourseWork pode ter no máximo 10 metas de aprendizado. Esse campo só é preenchido se o previewVersion apropriado estiver definido.
Detalhes adicionais específicos de um tipo de atividade. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
assignment

object (Assignment)

Detalhes da atribuição. Isso é preenchido apenas quando workType é ASSIGNMENT.

Somente leitura.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Detalhes da pergunta de múltipla escolha. Para operações de leitura, esse campo é preenchido somente 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. Caso contrário, ele não pode ser definido.
Fim dos campos mutuamente exclusivos.
gradingPeriodId

string

Identificador do período de avaliação associado à atividade.

  • Na criação, se não for especificado, o ID do período de avaliação será definido com base em 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 que já existe no curso.

CourseWorkState

Possíveis estados de uma atividade do curso.

Tipos enumerados
COURSE_WORK_STATE_UNSPECIFIED Nenhum estado especificado. Isso nunca é retornado.
PUBLISHED Status do trabalho que foi publicado. Esse é o estado padrão.
DRAFT Status de um trabalho que ainda não foi publicado. Os trabalhos nesse estado ficam visíveis apenas para os professores do curso e os administradores do domínio.
DELETED Status do trabalho que foi publicado, mas foi excluído. Os trabalhos nesse estado ficam visíveis apenas para os professores do curso e os administradores do domínio. O trabalho nesse estado é excluído depois de algum tempo.

SubmissionModificationMode

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

Tipos enumerados
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nenhum modo de modificação foi especificado. Isso nunca é retornado.
MODIFIABLE_UNTIL_TURNED_IN Os envios podem ser modificados antes de serem entregues.
MODIFIABLE Os envios podem ser modificados a qualquer momento.

Atribuição

Mais detalhes sobre as atividades.

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

object (DriveFolder)

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

MultipleChoiceQuestion

Detalhes adicionais para perguntas de múltipla escolha.

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

string

Opções possíveis.

Métodos

create

 Cria atividades do curso.

delete

 Exclui uma atividade do curso.

get

 Retorna as atividades do curso.

getAddOnContext

 Recebe metadados de 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 ver.

modifyAssignees

 Modifica o modo e as opções de responsável de uma atividade.

patch

 Atualiza um ou mais campos de uma atividade.