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 do curso atribuído pelo Google Sala de Aula.

Quando creating a course, você pode definir esse identificador como um alias string na solicitação para criar um alias correspondente. O id ainda é atribuído pelo Google Sala de Aula e não pode ser atualizado após a criação do curso.

Especificar esse campo em uma máscara de atualização de curso resulta em um erro.

string

Nome do curso. Por exemplo, "Biologia para o 1o ano". O nome é obrigatório. Precisa ter entre 1 e 750 caracteres e ser 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 10º 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 por meio de uma combinação de livros didáticos, palestras de convidados e trabalhos de laboratório. Espero que você esteja animado!" Se definido, esse campo precisa ser uma string UTF-8 válida e não pode ter mais de 30.000 caracteres.

string

Local do quarto opcional. Por exemplo, "301". Se definido, esse 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 um patch course request para transferir a propriedade. Em outros contextos, ele é somente leitura.

string (Timestamp format)

Hora de criação do curso. Especificar esse campo em uma máscara de atualização de curso resulta em um 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 deste curso. Especificar esse campo em uma máscara de atualização de curso resulta em um 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 IU 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 Drive compartilhada com todos os professores do curso.

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

Somente leitura.

object (CourseMaterialSet)

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

Somente leitura.

boolean

Indica se as notificações para responsáveis estão ativadas ou não para este curso.

Somente leitura.

string

O ID da agenda que todos os participantes do curso podem acessar e onde o Google Sala de Aula adiciona eventos de trabalhos e avisos.

O calendário de um curso é criado 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 pela API). O ID do calendário não será preenchido até que o processo de criação seja concluído.

Somente leitura.

object (GradebookSettings)

As configurações da plataforma de boletim de notas que especificam como a nota geral de um estudante para o curso será calculada e para quem ela será exibida.

Somente leitura

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

string

Título do 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)

Link de anexo.

object (Form)

Anexo do Formulários Google.

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

enum (CalculationType)

Indica como a nota geral é calculada.

enum (DisplaySetting)

Indica quem pode ver a nota final.

object (GradeCategory)

Categorias de nota disponíveis para as atividades do curso.