REST Resource: courses.courseWork

Recurso: CourseWork

Trabalho do curso criado por um professor para os estudantes do curso.

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 pela sala de aula para essa atividade, exclusivo para cada 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 do trabalho do curso. Se definido, a descrição precisa ser uma string UTF-8 válida com no máximo 30.000 caracteres.
materials[]

object (Material)

Outros materiais.

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

enum (CourseWorkState)

Status do trabalho do curso. Se não for especificado, o estado padrão será DRAFT.
creationTime

string (Timestamp format)

Carimbo de data/hora em que o trabalho do curso foi criado.

Somente leitura.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Somente leitura.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
dueDate

object (Date)

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

object (TimeOfDay)

Horário opcional, em UTC, para a entrega dos trabalhos do curso. Precisa ser especificado se dueDate for especificado.
scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional quando o trabalho do curso está programado para ser publicado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
maxPoints

number

Nota máxima para o trabalho do curso. Se o valor for zero ou não especificado, a atividade será considerada sem nota. Precisa ser um valor inteiro não negativo.
workType

enum (CourseWorkType)

Tipo de trabalho do curso.

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

boolean

Se o item do trabalho do curso está associado ao projeto do console do desenvolvedor que está fazendo a solicitação.

Consulte courseWork.create para mais detalhes.

Somente leitura.
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

Identificadores de estudantes com acesso ao curso. Esse campo só é 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ções 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 o trabalho.

Somente leitura.
topicId

string

Identificador do tópico associado a este trabalho de curso. Precisa corresponder a um tópico existente no curso.
gradeCategory

object (GradeCategory)

A categoria para a qual a nota da atividade contribui. Aparece somente quando uma categoria foi escolhida para o trabalho. Pode ser usado para calcular a nota geral.

Somente leitura.
previewVersion

enum (PreviewVersion)

Apenas saída. A versão de pré-lançamento da API usada para recuperar esse recurso.
Campo de união details. Detalhes adicionais específicos para um tipo de trabalho do curso. details pode ser apenas de um dos tipos a seguir:
assignment

object (Assignment)

Detalhes da atividade. Esse campo é 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 trabalhos de curso com um workType de MULTIPLE_CHOICE_QUESTION. Caso contrário, ele não pode ser definido.
gradingPeriodId

string

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

  • 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 com 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 do trabalho do curso.

Enums
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 trabalho que ainda não foi publicado. O trabalho nesse estado só fica visível para os professores do curso e administradores de domínio.
DELETED Status de um trabalho que foi publicado, mas foi excluído. O trabalho nesse estado só fica visível para os professores do curso e administradores de domínio. O trabalho nesse estado é excluído após algum tempo.

SubmissionModificationMode

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

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

Atribuição

Detalhes adicionais sobre as atividades.

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

object (DriveFolder)

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

MultipleChoiceQuestion

Detalhes adicionais para perguntas de múltipla escolha.

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

string

Possíveis escolhas.

Métodos

create

 Cria trabalhos do curso.

delete

 Exclui um trabalho do curso.

get

 Retorna o trabalho do curso.

getAddOnContext

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

list

 Retorna uma lista de trabalhos do curso que o solicitante tem permissão para acessar.

modifyAssignees

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

patch

 Atualiza um ou mais campos de um trabalho do curso.