REST Resource: courses.courseWorkMaterials

Recurso: CourseWorkMaterial

Material de 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 (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
Campos
courseId

string

Identificador do curso.

Somente leitura.

id

string

Identificador atribuído pelo Google Sala de Aula para esse material de trabalho do curso, exclusivo por curso.

Somente leitura.

title

string

Título desse material de trabalho do curso. O título precisa ser uma string UTF-8 válida que contenha entre 1 e 3.000 caracteres.

description

string

Descrição opcional desse material de trabalho do curso. O texto precisa ser uma string UTF-8 válida que contenha no máximo 30.000 caracteres.

materials[]

object (Material)

Outros recursos.

Um material de trabalho do curso não pode ter mais de 20 itens de material.

state

enum (CourseWorkMaterialState)

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

creationTime

string (Timestamp format)

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

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 nesse material de trabalho do curso.

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".

scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional em que esse material de trabalho do curso está programado para ser publicado.

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".

assigneeMode

enum (AssigneeMode)

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

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores de estudantes com acesso ao material de trabalho do curso. Esse campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se o assigneeMode for INDIVIDUAL_STUDENTS, somente os estudantes especificados nesse campo poderão ver o material de trabalho do curso.

creatorUserId

string

Identificador do usuário que criou o material de trabalho do curso.

Somente leitura.

topicId

string

Identificador do tópico ao qual esse material de trabalho do curso está associado. Precisa corresponder a um tópico existente no curso.

learningGoals[]

object (LearningGoal)

Opcional.

Referências a metas de aprendizado anexadas a esse material de trabalho do curso. O CourseWorkMaterial pode ter no máximo 10 metas de aprendizado. Esse campo só será preenchido se a previewVersion apropriada estiver definida.

CourseWorkMaterialState

Possíveis estados do material de trabalho do curso

Tipos enumerados
COURSEWORK_MATERIAL_STATE_UNSPECIFIED Nenhum estado especificado. Isso nunca é retornado.
PUBLISHED Status do material de trabalho do curso que foi publicado. Esse é o estado padrão.
DRAFT Status de um material de trabalho do curso que ainda não foi publicado. O material de trabalho do curso nesse estado fica visível apenas para professores e administradores de domínio.
DELETED Status do material de trabalho do curso que foi publicado, mas agora está excluído. O material de trabalho do curso nesse estado fica visível apenas para professores e administradores de domínio. O material de trabalho do curso nesse estado é excluído após algum tempo.

Métodos

create

Cria um material de trabalho do curso.

delete

Exclui um material de trabalho do curso.

get

Retorna um material de 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 materiais de trabalho do curso que o solicitante tem permissão para visualizar.

patch

Atualiza um ou mais campos de um material de trabalho do curso.