Estrutura de rubricas e limitações conhecidas

Se você não conhece as rubricas do Google Sala de Aula, consulte estes artigos da Central de Ajuda para saber mais sobre a estrutura geral de uma rubrica e como a avaliação com rubrica é feita na interface do Google Sala de Aula.

Estrutura das rubricas

Há alguns conceitos importantes que podem ser destacados ao usar a API para interagir com rubricas:

• Há (no máximo) uma única rubrica associada a um CourseWork e essa rubrica é exclusiva desse CourseWork (não pode ser compartilhada entre CourseWork recursos).
• A rubrica consiste em critérios, que consistem em níveis. Uma rubrica sempre precisa ter pelo menos um critério, e um critério sempre precisa ter pelo menos um nível.
• Os níveis podem ser pontuados (ter pontos) ou não pontuados (sem pontos). Os níveis precisam ser totalmente pontuados ou totalmente não pontuados em uma rubrica.
  • Se os níveis forem pontuados, todos os níveis em um critério precisam ter um valor de pontos exclusivo definido. Os pontos podem ser números inteiros (como 10) ou valores de ponto flutuante (como 9,99). Isso pode incluir 0. Valores nulos não são aceitos. Além disso, uma rubrica não pode ter um único critério com um único nível de 0 pontos.
  • Se os níveis não forem pontuados, o campo de pontos precisará ser omitido. Valores nulos não são aceitos.
• A ordem dos critérios e níveis é significativa e reflete a ordem em que são representados na interface do Google Sala de Aula.
  • Os níveis pontuados, em particular, precisam sempre ser classificados por pontos em ordem crescente ou decrescente.
• É possível criar até 50 critérios por rubrica e até dez níveis de desempenho por critério.

Campos relacionados ao envio de estudantes

StudentSubmission objetos oferecem suporte a campos relacionados a rubricas:

• Além das propriedades draftGrade e assignedGrade, um envio de estudante avaliado com uma rubrica tem as propriedades draftRubricGrades e assignedRubricGrades. Elas representam as notas da rubrica (níveis selecionados e valores de pontos) que o estudante recebe durante a avaliação da rubrica, nos estados de rascunho e atribuído, respectivamente.
• No momento, essas propriedades são somente leitura. Isso significa que a API não pode ser usada para avaliar envios, mas é possível ler envios avaliados na interface do Google Sala de Aula.

Comportamentos das rubricas

A API tem como objetivo espelhar a interface do Google Sala de Aula sempre que possível para consistência, mas isso pode levar a um comportamento que pode ser não intuitivo para os desenvolvedores e vale a pena mencionar:

• As rubricas têm como objetivo orientar a avaliação sem restringir os professores. Como resultado, um professor pode fazer o seguinte ao avaliar um envio com uma rubrica:
  • Ignorar completamente a rubrica ao avaliar.
  • Substituir os pontos de um critério, independentemente dos pontos disponíveis nos níveis do critério.
  • Selecionar níveis apenas para um subconjunto de critérios.
  • Atribuir pontos a um critério sem selecionar um nível correspondente.
  • Substituir o total de pontos da atividade, independentemente dos pontos que viriam da rubrica.

Além disso, a API não oferece suporte a comportamentos que a interface do Google Sala de Aula ainda não tem. Por exemplo, a API não permite impor o uso de rubricas em atividades ou substituir a capacidade de um professor de editar rubricas e envios como eles podem fazer hoje.

Limitações durante a avaliação

Da mesma forma, há algumas limitações adicionais na edição de rubricas depois que um professor começa a avaliar com ela. Somente as seguintes edições são possíveis após o início da avaliação:

• As edições de texto são permitidas para títulos e descrições de critérios e níveis.
• A ordem dos níveis pode mudar nos critérios.

Escopos adicionais

As rubricas podem ser manualmente exportadas para o Google Planilhas para serem reutilizadas pelos professores.

Se você criar ou atualizar uma rubrica dessas planilhas (consulte um exemplo no guia), seu aplicativo precisará solicitar o escopo https://www.googleapis.com/auth/spreadsheets.readonly ou https://www.googleapis.com/auth/spreadsheets. Esteja ciente de que os spreadsheets escopos são considerados confidenciais e podem exigir que seu aplicativo seja verificado.

Atividades de terceiros

As rubricas só podem ser criadas pelo projeto na nuvem do Google Cloud que criou o item CourseWork pai. Esse é um padrão de design mais amplo na API Google Classroom que impede que aplicativos diferentes afetem recursos que não são deles.

Isso se estende aos recursos criados pelos usuários no app Google Sala de Aula. Por exemplo, não é possível que um aplicativo gerencie rubricas para uma atividade criada por um professor na interface do Google Sala de Aula, mesmo que o mesmo professor seja o proprietário do aplicativo. Se isso limitar significativamente seu caso de uso, compartilhe feedback no rastreador de problemas públicos.

Requisitos de licença

Prévia: a partir da versão V1_20260316_PREVIEW do Programa de prévia para desenvolvedores do Google Workspace, os métodos de rubricas na API Google Classroom não exigem mais uma licença Plus. Todas as ações de rubricas estão disponíveis para todos os usuários do Google Workspace for Education. Consulte Recursos e roteiro da prévia para saber como participar do programa e usar os recursos da API com uma versão de prévia.

Um usuário só pode criar, atualizar e excluir rubricas com a API Google Classroom se as seguintes condições forem atendidas:

• O usuário que faz a solicitação tem uma licença do Google Workspace for Education Plus atribuída a ele.
• O proprietário do curso correspondente tem uma licença do Google Workspace for Education Plus atribuída a ele.

Consulte a qualificação do usuário para saber mais sobre como os recursos da API são expostos aos usuários e os pré-requisitos da API Google Classroom para conhecer e solicitar uma conta de demonstração para desenvolvimento.