Method: courses.courseWork.rubrics.patch

Atualiza uma rubrica.

Consulte google.classroom.v1.Rubric para mais detalhes sobre quais campos podem ser atualizados. Os recursos de atualização da rubrica são limitados após o início da avaliação.

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

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

  • PERMISSION_DENIED se o projeto de desenvolvedor solicitante não tiver criado a atividade do curso correspondente, se o usuário não tiver permissão para fazer a modificação solicitada na rubrica ou se houver erros de acesso. Esse código de erro também será retornado se a avaliação já tiver começado na rubrica.
  • INVALID_ARGUMENT se a solicitação for corrompida e para o seguinte erro de solicitação:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND se o curso, o trabalho do curso ou a rubrica solicitado 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 na rubrica serão atualizados. Este campo é obrigatório para fazer uma atualização. A atualização falhará se campos inválidos forem especificados. Há várias opções para definir os critérios de uma rubrica: a lista de sourceSpreadsheetId e a criteria. Apenas um deles pode ser usado por vez para definir uma rubrica.

A lista criteria da rubrica foi 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 existentes vão manter o ID atribuído anteriormente se o ID for especificado na solicitação.

Os professores podem especificar os seguintes campos:

  • criteria
  • sourceSpreadsheetId

Esta é 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 os novos recursos da API disponibilizados aos desenvolvedores no Programa de testes.

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.