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 da rubrica é feita em a interface do Google Sala de Aula.

Estrutura das rubricas

Há alguns conceitos importantes que podem valer a pena destacar ao usar os API para interagir com rubricas:

  • Há (no máximo) uma única rubrica associada a um CourseWork e a rubrica é exclusiva a esse CourseWork (não é compartilhável entre CourseWork).
  • A rubrica consiste em critérios, que consistem em níveis. Uma rubrica deve sempre terão pelo menos um critério, e um critério sempre deverá ter pelo menos um nível.
  • Os níveis podem ser pontuados (com pontos) ou sem pontuação (sem pontos). Os níveis devem ser totalmente ou totalmente sem pontuação em uma rubrica.
    • Se os níveis forem pontuados, todos os níveis em um critério deverão ter um atributo de pontuação definido. Os pontos podem ser números inteiros (como 10) ou pontos flutuantes (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 ou seja, zero pontos.
    • Se os níveis não tiverem pontuação, o campo "points" será omitido. nulo 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 devem sempre ser 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 de envio dos estudantes também estão mudando:

  • Além das propriedades draftGrade e assignedGrade existentes, um o trabalho enviado pelo estudante avaliado com uma rubrica tem draftRubricGrades e assignedRubricGrades. Eles representam as notas da rubrica (níveis selecionados e a pontuação) que o aluno recebe durante a avaliação do para os estados "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 os envios, mas você pode ler os envios que valem nota na Interface do Google Sala de Aula.
  • Os envios dos estudantes com uma rubrica associada contêm um campo "rubricId". Este campo representa a rubrica mais recente associada a CourseWork, e esse valor pode mudar se os professores excluírem e recriarem uma rubrica.

Comportamentos das rubricas

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

  • As rubricas servem para orientar a avaliação sem restringir os professores. Como resultado, o professor pode fazer o seguinte ao avaliar um trabalho com um 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 para apenas um subconjunto de critérios.
    • Atribua pontos para um critério sem selecionar um nível correspondente.
    • Substituir o total de pontos da atividade, independente dos pontos viria da rubrica.

Além disso, a API não está introduzindo novos recursos de produto. Em outras a API não é compatível com o comportamento que a interface do Google Sala de Aula ainda não tem. Por exemplo, a API não permite a aplicação obrigatória do uso de rubricas em atividades ou substitui a capacidade do professor de editar rubricas e envios como possível hoje mesmo.

Limitações durante a avaliação

Da mesma forma, existem algumas limitações adicionais na edição de rubricas uma vez que um professor iniciou a avaliação com ele. Somente as seguintes edições são possíveis após avaliação desde o início:

  • É permitido editar títulos e descrições de critérios e níveis.
  • A ordem dos níveis pode mudar de acordo com os critérios.

Escopos adicionais

As rubricas podem ser exportadas manualmente para o Planilhas Google para reutilizá-las professores.

Se você criar ou atualizar uma rubrica nessas planilhas (veja um exemplo na guia), seu aplicativo precisa solicitar as https://www.googleapis.com/auth/spreadsheets.readonly ou escopo https://www.googleapis.com/auth/spreadsheets. Esteja ciente de que o spreadsheets escopos são considerados sensíveis e podem exigir que seu aplicativo precisam ser verificados.