Method: courses.updateGradingPeriodSettings

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

É possível adicionar, remover ou modificar períodos de avaliação individuais usando esse método.

O usuário solicitante e o proprietário do curso precisam estar qualificados para modificar os períodos de avaliação. Para mais detalhes, consulte os requisitos de licenciamento.

Esse método retorna os seguintes códigos de erro:

  • PERMISSION_DENIED se o usuário solicitante não tiver permissão para modificar as configurações do período de avaliação em um curso ou em caso de erros de acesso:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT se a solicitação estiver incorreta.
  • NOT_FOUND, se o curso solicitado não existir.

Solicitação HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
courseId

string

Obrigatório. O identificador do curso.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara que identifica quais campos em "GradingPeriodSettings" serão atualizados.

A lista gradingPeriods de GradingPeriodSettings será totalmente substituída pelos períodos de avaliação especificados na solicitação de atualização. Exemplo:

  • Os períodos de avaliação incluídos na lista sem um ID são considerados adições, e um novo ID será atribuído quando a solicitação for feita.
  • Os períodos de avaliação que existem atualmente, mas estão ausentes da solicitação, serão considerados exclusões.
  • Os períodos de avaliação com um ID e dados modificados são considerados edições. Os dados não modificados vão permanecer como estão.
  • Períodos de avaliação incluídos com um ID desconhecido vão resultar em um erro.

Os seguintes campos podem ser especificados:

  • gradingPeriods
  • applyToExistingCoursework

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcional. A versão de pré-lançamento da API. É necessário definir esse valor para acessar os novos recursos de API disponibilizados para os desenvolvedores no programa de visualização.

Corpo da solicitação

O corpo da solicitação contém uma instância de GradingPeriodSettings.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de GradingPeriodSettings.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/classroom.courses

Para mais informações, consulte o guia de autorização.