Method: courses.updateGradingPeriodSettings

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

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 devido a 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 do 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 atuais que não estiverem na solicitação serão considerados como exclusões.
  • Os períodos de avaliação com um ID e dados modificados são considerados edições. Os dados não modificados serão mantidos como estão.
  • Os períodos de avaliação incluídos com um ID desconhecido vão resultar em 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. Isso precisa ser definido para acessar as novas funcionalidades da API disponibilizadas para os desenvolvedores no Programa de testes.

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.