REST Resource: courses

{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}

string

Identificador deste curso atribuído pelo Google Sala de Aula.

Quando creating a course, é possível definir esse identificador como um alias string na solicitação para criar um alias correspondente. A atividade id é atribuída pelo Google Sala de Aula e não pode ser atualizada após a criação do curso.

A especificação desse campo em uma máscara de atualização de curso resulta em erro.

string

Nome do curso. Por exemplo, "Biologia para o 1o ano". O nome é obrigatório. Ele precisa ter entre 1 e 750 caracteres e uma string UTF-8 válida.

string

Seção do curso. Por exemplo, "Período 2". Se definido, esse campo precisa ser uma string UTF-8 válida e não pode ter mais de 2.800 caracteres.

string

Cabeçalho opcional para a descrição. Por exemplo, "Bem-vindo à biologia do 1o ano". Se definido, esse campo precisa ser uma string UTF-8 válida e não pode ter mais de 3.600 caracteres.

string

Descrição opcional. Por exemplo: "Vamos aprender sobre a estrutura de criaturas vivas com uma combinação de livros didáticos, palestras de convidados e trabalhos de laboratório. Espere estar animado!" Se definido, este campo precisa ser uma string UTF-8 válida e não pode ter mais de 30.000 caracteres.

string

Local da sala opcional. Por exemplo, "301". Se definido, este campo precisa ser uma string UTF-8 válida e não pode ter mais de 650 caracteres.

string

O identificador do proprietário de um curso.

Quando especificado como um parâmetro de um create course request, esse campo é obrigatório. O identificador pode ser um dos seguintes:

• o identificador numérico do usuário
• o endereço de e-mail do usuário
• o literal de string "me", indicando o usuário solicitante

Isso precisa ser definido em uma solicitação de criação. Os administradores também podem especificar esse campo em uma patch course request para transferir a propriedade. Em outros contextos, ele é somente leitura.

string (Timestamp format)

Horário de criação do curso. A especificação desse campo em uma máscara de atualização de curso resulta em erro.

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

string (Timestamp format)

Hora da atualização mais recente deste curso. A especificação desse campo em uma máscara de atualização de curso resulta em erro.

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

string

Código de inscrição para usar ao participar do curso. A especificação desse campo em uma máscara de atualização de curso resulta em erro.

Somente leitura.

enum (CourseState)

Estado do curso. Se não for especificado, o estado padrão será PROVISIONED.

string

Link absoluto para este curso na interface da Web do Google Sala de Aula.

Somente leitura.

string

O endereço de e-mail de um Grupo do Google que contém todos os professores do curso. Este grupo não aceita e-mail e só pode ser usado para permissões.

Somente leitura.

string

O endereço de e-mail de um Grupo do Google que contém todos os participantes do curso. Este grupo não aceita e-mail e só pode ser usado para permissões.

Somente leitura.

object (DriveFolder)

Informações sobre uma pasta do Google Drive compartilhada com todos os professores do curso.

Este campo só será definido para professores do curso e administradores do domínio.

Somente leitura.

object (CourseMaterialSet)

Conjuntos de materiais que aparecem no "Sobre" página deste curso.

Somente leitura.

boolean

Se as notificações para os responsáveis estão ativadas para este curso.

Somente leitura.

string

O ID da agenda que pode ser acessada por todos os participantes do curso e pode ser acessada por todos os participantes do curso. O Google Sala de Aula adiciona eventos aos trabalhos e aos avisos do curso.

A Agenda de um curso é criada de forma assíncrona quando o curso é definido como CourseState.ACTIVE pela primeira vez (no momento da criação ou quando é atualizado para ACTIVE pela interface ou API). O ID da agenda não será preenchido até que o processo de criação seja concluído.

Somente leitura.

object (GradebookSettings)

As configurações do boletim de notas que especificam como será calculada a nota final de um estudante no curso e para quem ela será exibida.

Somente leitura

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

Título deste conjunto.

object (CourseMaterial)

Materiais anexados a este conjunto.

{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}

object (DriveFile)

Anexo de arquivo do Google Drive.

object (YouTubeVideo)

Anexo de vídeo do YouTube.

object (Link)

Vinculação de link.

object (Form)

Anexo do Formulários Google.

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

Indica como a nota final é calculada.

enum (DisplaySetting)

Indica quem pode ver a nota final.

object (GradeCategory)

As categorias de notas disponíveis para as atividades do curso.