REST Resource: courses.courseWork

Recurso: tarefas do curso

Atividades criadas por um professor para os alunos 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 pelo Google Sala de Aula para o trabalho do curso, exclusivo para cada curso.

Somente leitura.

title

string

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

description

string

Descrição opcional do trabalho do curso. Se definida, a descrição precisa ser uma string UTF-8 válida contendo no máximo 30.000 caracteres.

materials[]

object (Material)

Materiais adicionais.

O curso não pode ter mais de 20 itens de materiais.

state

enum (CourseWorkState)

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

creationTime

string (Timestamp format)

Carimbo de data/hora em que este 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 neste 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 fuso horário UTC, em que os envios deste trabalho do curso vencem. Será necessário especificar se dueTime for especificado.

dueTime

object (TimeOfDay)

Hora do dia opcional, em UTC, em que os envios para este trabalho do curso têm o prazo. Será necessário especificar se dueDate for especificado.

scheduledTime

string (Timestamp format)

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

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 deste curso. Se zero ou um valor não especificado, a atividade será considerada sem nota. Precisa ser um número 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 está fazendo a solicitação.

Consulte courseWork.create para mais detalhes.

Somente leitura.

assigneeMode

enum (AssigneeMode)

Modo do responsável do curso. Se não for especificado, o valor padrão será ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores dos alunos com acesso às atividades. 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 associado a este curso. Precisa corresponder a um tema atual no curso.

gradeCategory

object (GradeCategory)

A categoria para a qual a nota deste curso contribui. Presente apenas quando uma categoria tiver sido escolhida para o curso. 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 este 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 atribuição. Ele é 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 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 e não pode ser definido de outra forma.

gradingPeriodId

string

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

  • Se não for especificado, o ID do período de avaliação vai ser definido com base na dueDate (ou na scheduledTime se nenhuma dueDate estiver definida).
  • Para não indicar nenhuma associação a um período de avaliação, defina este campo como uma string vazia ("").
  • Se especificado, ele precisa corresponder a um ID do período de avaliação atual no curso.

CourseWorkState

Os possíveis estados do curso funcionam.

Enums
COURSE_WORK_STATE_UNSPECIFIED Nenhum estado especificado. Ele 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 só ficam visíveis 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 só ficam visíveis para os professores do curso e os administradores do domínio. O trabalho neste estado é excluído após algum tempo.

SubmissionModificationMode

Possíveis modos de modificação para os envios dos alunos.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nenhum modo de modificação especificado. Ele 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 das atribuições.

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

object (DriveFolder)

Pasta do Google Drive com anexos dos arquivos enviados pelos estudantes. 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

Possíveis opções.

Métodos

create

Cria o trabalho do curso.

delete

Exclui um trabalho do curso.

get

Retorna o 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 trabalhos que o solicitante tem permissão para visualizar.

modifyAssignees

Modifica o modo do cessionário e as opções de um curso.

patch

Atualiza um ou mais campos do trabalho de um curso.