Method: courses.courseWork.rubrics.patch

Atualiza uma rubrica.

Consulte google.classroom.v1.Rubric para saber quais campos podem ser atualizados. Os recursos de atualização da rubrica são limitados quando a avaliação começa.

O usuário solicitante e o proprietário do curso precisam ter capacidade de criar avaliações. Para mais detalhes, consulte os requisitos de licenciamento.

Essa solicitação precisa ser feita pelo console do Google Cloud do ID do cliente OAuth usado para criar o item de trabalho do curso pai.

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

  • PERMISSION_DENIED se o projeto do desenvolvedor solicitante não criou o trabalho do curso correspondente, se o usuário não tem permissão para fazer a modificação solicitada na rubrica ou por erros de acesso. Esse código de erro também é retornado se a avaliação já tiver começado na rubrica.
  • INVALID_ARGUMENT se a solicitação estiver incorreta e para o seguinte erro de solicitação:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND se o curso, o trabalho do curso ou a rubrica solicitados não existirem ou se o usuário não tiver acesso ao trabalho do curso correspondente.
  • INTERNAL se a avaliação já tiver começado na rubrica.

Solicitação HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

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

Parâmetros de caminho

Parâmetros
courseId

string

Obrigatório. Identificador do curso.
courseWorkId

string

Obrigatório. Identificador do trabalho do curso.
id

string

Opcional. Identificador da rubrica.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Opcional. Máscara que identifica quais campos da rubrica serão atualizados. Este campo é obrigatório para fazer uma atualização. A atualização falha se campos inválidos forem especificados. Há várias opções para definir os critérios de uma rubrica: a sourceSpreadsheetId e a lista criteria. Apenas uma delas pode ser usada por vez para definir uma rubrica.

A lista de criteria da rubrica é totalmente substituída pelos critérios de rubrica especificados na solicitação de atualização. Por exemplo, se um critério ou nível estiver ausente na solicitação, ele será excluído. Novos critérios e níveis são adicionados, e um ID é atribuído. Os critérios e níveis atuais mantêm o ID atribuído anteriormente se ele for especificado na solicitação.

Os professores podem especificar os seguintes campos:

  • criteria
  • sourceSpreadsheetId

É 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 Rubric.

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

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