REST Resource: courses

Recurso: curso

um curso no Google Sala de Aula.

Representação JSON
{
  "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)
  }
}
Campos
id

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.

name

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.

section

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.

descriptionHeading

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.

description

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.

room

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.

ownerId

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.

creationTime

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

updateTime

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

enrollmentCode

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.

courseState

enum (CourseState)

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

teacherGroupEmail

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.

courseGroupEmail

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.

teacherFolder

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.

courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

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

Somente leitura.

guardiansEnabled

boolean

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

Somente leitura.

calendarId

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.

gradebookSettings

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

CourseState

São os possíveis estados em que um curso pode estar.

Enums
COURSE_STATE_UNSPECIFIED Nenhum estado do curso. Nenhuma mensagem de curso retornada vai usar esse valor.
ACTIVE O curso está ativo.
ARCHIVED O curso foi arquivado. Não é possível modificá-lo, exceto para alterá-lo para um estado diferente.
PROVISIONED O curso foi criado, mas ainda não foi ativado. Ele pode ser acessado pelo professor principal e pelos administradores do domínio, que podem modificá-lo ou alterá-lo para os estados ACTIVE ou DECLINED. Um curso só pode ser alterado para PROVISIONED se estiver no estado DECLINED.
DECLINED O curso foi criado, mas recusado. Ele pode ser acessado pelo proprietário do curso e pelos administradores do domínio, embora não seja exibido na interface da Web. Não é possível modificar o curso, exceto para alterá-lo para o estado PROVISIONED. Um curso só pode ser alterado para DECLINED se estiver no estado PROVISIONED.
SUSPENDED O curso foi suspenso. Não é possível modificar o curso, e ele só pode ser acessado pelo usuário identificado pelo ownerId. Um curso pode ser colocado nesse estado se violar os Termos de Serviço.

CourseMaterialSet

Um conjunto de materiais que aparece na página "Sobre" nesta página do curso. Esses materiais podem incluir um plano de aula, cronograma ou outras informações básicas relacionadas ao curso como um todo.

Representação JSON
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
Campos
title

string

Título deste conjunto.

materials[]

object (CourseMaterial)

Materiais anexados a este conjunto.

CourseMaterial

Um material anexado a um curso como parte de um conjunto de materiais.

Representação JSON
{

  // 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.
}
Campos
Campo de união material. Dados do Material Design. material pode ser apenas de um dos tipos a seguir:
driveFile

object (DriveFile)

Anexo de arquivo do Google Drive.

youTubeVideo

object (YouTubeVideo)

Anexo de vídeo do YouTube.

form

object (Form)

Anexo do Formulários Google.

GradebookSettings

As configurações do diário de classe de um curso. Consulte este artigo da Central de Ajuda para mais detalhes.

Representação JSON
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
Campos
calculationType

enum (CalculationType)

Indica como a nota final é calculada.

displaySetting

enum (DisplaySetting)

Indica quem pode ver a nota final.

gradeCategories[]

object (GradeCategory)

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

CalculationType

Possíveis métodos de cálculo da nota final.

Enums
CALCULATION_TYPE_UNSPECIFIED Nenhum método especificado. Ele nunca é retornado.
TOTAL_POINTS A nota final é a soma das notas dividida pela soma do total de pontos, independentemente da categoria.
WEIGHTED_CATEGORIES A nota final é a média ponderada por categoria.

DisplaySetting

Possíveis configurações para exibir a nota final.

Enums
DISPLAY_SETTING_UNSPECIFIED Nenhuma configuração especificada. Ele nunca é retornado.
SHOW_OVERALL_GRADE Mostra a nota final no diário de classe e no perfil do estudante para professores e estudantes.
HIDE_OVERALL_GRADE Não mostra a nota final no diário de classe ou no perfil do estudante.
SHOW_TEACHERS_ONLY Mostra a nota final aos professores no boletim de notas e no perfil do estudante. Oculta dos estudantes no perfil deles.

Métodos

checkAddOnCreationEligibility

Informa se um usuário está qualificado para criar anexos de complementos em um determinado curso.

checkGradingPeriodsSetupEligibility

Retorna se um usuário está qualificado para atualizar GradingPeriodSettings em um determinado curso.

create

Cria um curso.

delete

Exclui um curso.

get

Retorna um curso.

getGradingPeriodSettings

Retorna as configurações do período de avaliação de um curso.

list

Retorna uma lista de cursos que o usuário solicitante tem permissão para visualizar, restritos àqueles que correspondem à solicitação.

patch

Atualiza um ou mais campos em um curso.

update

Atualiza um curso.

updateGradingPeriodSettings

Atualiza as configurações do período de avaliação de um curso.