Method: courses.courseWork.rubrics.patch

• Solicitação HTTP
• Parâmetros de caminho
• Parâmetros de consulta
• Corpo da solicitação
• Corpo da resposta
• Escopos de autorização

Prévia para desenvolvedores:disponível como parte do Programa de prévia para desenvolvedores do Google Workspace, que dá acesso antecipado a determinados recursos. Esse recurso está disponível no V1_20231110_PREVIEW e em versões mais recentes. Consulte Acessar APIs de visualização para saber mais.

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
Importante:para criar uma rubrica em uma planilha Google especificando o sourceSpreadsheetId, são necessários escopos adicionais: https://www.googleapis.com/auth/spreadsheets.readonly ou https://www.googleapis.com/auth/spreadsheets. Os escopos spreadsheets são considerados sensíveis e podem exigir que seu aplicativo seja verificado.

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