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 classificação de rubricas é feita na IU 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 uma CourseWork, e essa rubrica é exclusiva para esse CourseWork (ela não pode ser compartilhada entre recursos de CourseWork).
  • A rubrica consiste em critérios, que consistem em níveis. Uma rubrica precisa ter sempre 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 ter pontuação total ou totalmente sem pontuação em uma rubrica.
    • Se os níveis tiverem pontuação, todos os níveis de um critério vão precisar ter um valor de pontos exclusivo definido. Os pontos podem ser números inteiros (como 10) ou valores de ponto flutuante (como 9,99). 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 que seja 0 ponto.
    • Se os níveis não tiverem pontuação, o campo de pontos precisará ser omitido. Valores nulos não são aceitos.
  • A ordem dos critérios e dos níveis é significativa e reflete a ordem em que eles são representados na IU do Google Sala de Aula.
    • Os níveis pontuados precisam ser sempre classificados por pontos em ordem crescente ou decrescente.
  • Pode haver até 50 critérios por rubrica e até 10 níveis de desempenho por critério.

Os objetos Envio dos estudantes também vão mudar:

  • Além das propriedades draftGrade e assignedGrade, o envio de um estudante avaliado com uma rubrica tem as propriedades draftRubricGrades e assignedRubricGrades. Elas representam as notas da rubrica (níveis selecionados e pontuações) que o estudante recebe durante a avaliação da rubrica, nos estados de rascunho e atribuído, respectivamente.
  • Por enquanto, essas propriedades são somente leitura. Isso significa que a API não pode ser usada para avaliar envios, mas você pode ler os envios com nota na IU do Google Sala de Aula.
  • Os envios dos alunos com uma rubrica associada contêm um campo rubricId. Esse campo representa a rubrica mais recente associada à CourseWork e esse valor pode mudar se os professores excluirem e recriarem uma rubrica.

Comportamentos das rubricas

O objetivo da API é espelhar a IU do Google Sala de Aula sempre que possível para manter a consistência, mas isso pode levar a um comportamento que pode não ser intuitivo para os desenvolvedores e é importante mencionar:

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

Além disso, a API não está apresentando novos recursos de produto. Em outras palavras, a API não é compatível com um comportamento que ainda não está na IU do Google Sala de Aula. Por exemplo, a API não permite impor o uso de rubricas nas atividades ou substituir a capacidade de um professor editar rubricas e envios, como já acontece atualmente.

Limitações durante a avaliação

Da mesma forma, existem 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:

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

Escopos adicionais

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

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