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 sobre a estrutura geral de uma rubrica e como a avaliação de rubricas é feita na interface do Google Sala de Aula.

Estrutura das rubricas

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

  • Há (no máximo) uma única critérios associada a um CourseWork, e essa rubrica é exclusiva para esse CourseWork (não pode ser compartilhada entre recursos CourseWork).
  • A rubrica consiste em critérios, que consistem em níveis. Uma rubrica precisa sempre ter pelo menos um critério, e um critério precisa sempre ter pelo menos um nível.
  • Os níveis podem ser pontuados (têm pontos) ou não pontuados (não têm pontos). Os níveis precisam ter pontuação total ou não ter pontuação em uma rubrica.
    • Se os níveis forem pontuados, todos os níveis em um critério precisarão 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 tiverem pontuação, o campo "points" 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 eles são representados na interface do Google Sala de Aula.
    • Os níveis pontuados em particular precisam ser sempre classificados por pontos em ordem crescente ou decrescente.
  • É possível ter até 50 critérios por rubrica e até 10 níveis de desempenho por critério.

Os objetos de envio do estudante também estão mudando:

  • Além das propriedades draftGrade e assignedGrade, uma envio de estudante avaliado com uma rubrica tem propriedades draftRubricGrades e assignedRubricGrades. Eles 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 você pode ler os envios avaliados na interface do Google Sala de Aula.
  • Os envios dos estudantes com uma rubrica associada contêm um campo rubricId. Esse campo representa a última rubrica associada ao CourseWork, e esse valor pode mudar se os professores excluirem e recriarem uma rubrica.

Comportamentos das rubricas

A API tem como objetivo espelhar a interface 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 que vale a pena mencionar:

  • As rubricas têm o objetivo de orientar a avaliação sem restringir os professores. Como resultado, um professor pode fazer o seguinte ao avaliar uma atividade com uma rubrica:
    • Ignorar completamente a rubrica ao dar notas.
    • Substitua 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 para um critério sem selecionar um nível correspondente.
    • Substituir o total de pontos da atividade, independentemente dos pontos da rubrica.

Além disso, a API não está introduzindo novos recursos de produto. Em outras palavras, a API não oferece suporte ao comportamento que a interface do Google Sala de Aula já não tem. Por exemplo, a API não permite a aplicação do uso de rubricas em atividades ou substitui a capacidade de um professor editar rubricas e envios como faz atualmente.

Limitações durante a avaliação

Da mesma forma, também há algumas limitações adicionais na edição das rubricas quando um professor começa a avaliar com elas. Somente as seguintes edições são possíveis após a avaliação como iniciada:

  • As edições de texto são permitidas nos 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 as Planilhas Google para reutilização 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. Os escopos spreadsheets são considerados sensíveis e podem exigir que seu aplicativo seja verificado.

Anterior
Períodos de avaliação