Seus usuários usam o Google Sala de Aula com o Google Meet? Confira o guia de início rápido do Apps Script que mostra como verificar a participação dos alunos nos cursos do Google Meet.

REST Resource: courses.courseWork

Recurso: CourseWork

Trabalho do curso criado 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)
  },

  // 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 de curso, exclusivo para cada curso.

Somente leitura.
title

string

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

string

Descrição opcional deste trabalho. 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.

Os cursos não podem ter mais de 20 itens.
state

enum (CourseWorkState)

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

string (Timestamp format)

Carimbo de data/hora de quando o trabalho deste 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 alteração mais recente neste 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, para os trabalhos a serem entregues neste trabalho. Precisa ser especificado se dueTime for especificado.
dueTime

object (TimeOfDay)

A hora do dia, em UTC, é o prazo final das inscrições para os trabalhos do curso. Precisa ser especificado se dueDate for especificado.
scheduledTime

string (Timestamp format)

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

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

É a nota máxima deste trabalho. Se for igual a zero ou não especificada, a atribuição será considerada sem nota. Precisa ser um valor inteiro não negativo.
workType

enum (CourseWorkType)

Tipo deste trabalho.

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.

Veja courseWork.create para mais detalhes.

Somente leitura.
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

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

enum (SubmissionModificationMode)

Configuração para determinar quando os alunos 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 curso.

Somente leitura.
topicId

string

É o identificador do tópico ao qual o curso está associado. Precisa corresponder a um tema atual no curso.
gradeCategory

object (GradeCategory)

A categoria com que a nota deste curso contribui. Apresentar apenas quando uma categoria tiver sido escolhida para o curso. Pode ser usada para calcular a nota final.

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

object (Assignment)

Detalhes da atribuição. 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 e não pode ser definido de outra forma.

Estado do curso

Estados possíveis 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 da obra que ainda não foi publicada. Os trabalhos nesse estado ficam visíveis apenas para os professores e administradores do domínio.
DELETED Status da obra que foi publicada, mas foi excluída. Os trabalhos nesse estado ficam visíveis apenas para os professores e administradores do domínio. Os trabalhos nesse estado serão excluídos após algum tempo.

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data refere-se ao calendário gregoriano. Isso pode representar um dos seguintes:

  • Uma data completa, com valores de ano, mês e dia diferentes de zero.
  • Um mês e um dia, com um ano zero (por exemplo, um aniversário).
  • um ano sozinho, com um mês e zero um dia;
  • Um ano e mês, com um dia definido como zero (por exemplo, a data de validade de um cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9999, ou 0 para especificar uma data sem um ano.
month

integer

Mês de um ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia de um mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não seja significativo.

TimeOfDay

Representa um horário do dia. A data e o fuso horário não são relevantes ou são especificados em outro lugar. Uma API pode permitir segundos bissextos. Os tipos relacionados são google.type.Date e google.protobuf.Timestamp.

Representação JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas do dia no formato de 24 horas. Precisa ser de 0 a 23. Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.
minutes

integer

Minutos da hora do dia. Precisa ser de 0 a 59.
seconds

integer

Segundos do minutos do horário. Normalmente precisa ser de 0 a 59. Uma API pode permitir o valor 60 se permitir segundos bissextos.
nanos

integer

Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999.

SubmissionModifiedMode

Possíveis modos de modificação para os envios dos 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 da entrega.
MODIFIABLE Os envios podem ser modificados a qualquer momento.

Atribuição

Detalhes adicionais das atividades.

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

object (DriveFolder)

Pasta do Drive onde os anexos dos arquivos enviados pelos estudantes são colocados. Só é preenchido para professores e administradores do curso.

Pergunta de múltipla escolha

Mais detalhes para perguntas de múltipla escolha.

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

string

Opções possíveis.

Métodos

create

 Cria o trabalho do curso.

delete

 Exclui um trabalho do curso.

get

 Retorna os trabalhos do curso.

list

 Retorna uma lista das atividades do curso que o solicitante pode ver.

modifyAssignees

 Modifica o modo de responsável e as opções de um curso.

patch

 Atualiza um ou mais campos de um trabalho de curso.