REST Resource: courses.courseWork

Recurso: CourseWork

Trabalhos criados 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)
  },

  // 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 do curso.

Somente leitura.

id

string

Identificador atribuído pelo Google Sala de Aula deste trabalho do curso. Esse identificador é exclusivo para cada curso.

Somente leitura.

title

string

É o título deste 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 deste 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)

Materiais adicionais.

O CourseWork não pode ter mais de 20 itens do Material Design.

state

enum (CourseWorkState)

Status deste 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 UTC "Zulu" RFC3339, 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 UTC "Zulu" RFC3339, 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, em UTC, em que os envios para o trabalho deste curso precisam ser entregues. Precisará ser especificado se dueTime for especificado.

dueTime

object (TimeOfDay)

Horário opcional do dia, no fuso horário UTC, em que os envios para este trabalho do curso precisam ser entregues. Precisará ser especificado se dueDate for especificado.

scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional de quando o trabalho do curso está programado para publicação.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 deste trabalho do curso. Se o valor for zero ou não for 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

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

Consulte courseWork.create para mais detalhes.

Somente leitura.

assigneeMode

enum (AssigneeMode)

Modo do usuário atribuído das atividades. Se não for especificado, o valor padrão será ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores dos estudantes com acesso às atividades. Este campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se assigneeMode for INDIVIDUAL_STUDENTS, somente os estudantes especificados neste campo receberão a atividade.

submissionModificationMode

enum (SubmissionModificationMode)

Configuração para determinar quando os estudantes podem modificar 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 este curso está associado. Precisa corresponder a um tema do curso.

gradeCategory

object (GradeCategory)

A categoria com a qual a nota deste curso contribui. Apresentar somente quando uma categoria for escolhida para o curso. Pode ser usada no cálculo da nota final.

Somente leitura.

Campo de união details. Detalhes adicionais específicos de um tipo de trabalho do curso. details pode ser apenas de um dos tipos a seguir:
assignment

object (Assignment)

Detalhes da atividade Só é preenchido quando workType é ASSIGNMENT.

Somente leitura.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

Detalhes da pergunta de múltipla escolha Para 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 o trabalho do curso com um workType de MULTIPLE_CHOICE_QUESTION. Ele não pode ser definido de outra forma.

CourseWorkState

Estados possíveis do trabalho do curso.

Enums
COURSE_WORK_STATE_UNSPECIFIED Nenhum estado especificado. Nunca é retornado.
PUBLISHED Status do trabalho que foi publicado. Esse é o estado padrão.
DRAFT Status do trabalho que ainda não foi publicado. Os trabalhos nesse estado ficam visíveis apenas para os professores do curso e administradores do domínio.
DELETED Status do trabalho que foi publicado, mas agora está excluído. Os trabalhos nesse estado ficam visíveis apenas para os professores do curso e administradores do domínio. O trabalho neste estado é excluído após algum tempo.

SubmissionModificationMode

os possíveis modos de modificação para os envios dos estudantes.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nenhum modo de modificação especificado. 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

Detalhes adicionais das atribuições.

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

object (DriveFolder)

a pasta do Drive onde são colocados os anexos dos arquivos enviados pelos estudantes. Esse documento só é preenchido para os professores e administradores do curso.

MultipleChoiceQuestion

Mais detalhes para perguntas de múltipla escolha.

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

string

Possíveis escolhas.

Métodos

create

Cria o trabalho do curso.

delete

Exclui um trabalho do curso.

get

Retorna o trabalho do curso.

getAddOnContext

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

modifyAssignees

Modifica o modo do usuário e as opções das atividades.

patch

Atualiza um ou mais campos do trabalho de um curso.