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 vale a pena destacar ao usar a API para interagir com as 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 precisam ter um valor de pontos 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 de pontos precisa 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 com pontuação, 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 StudentSubmission são compatíveis com campos relacionados a rubricas:

  • 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.

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 rubric:
    • 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.
    • Atribuir pontos a um critério sem selecionar o nível correspondente.
    • Substitua o total de pontos da atividade, independentemente dos pontos que viriam da rubrica.

Além disso, a API não oferece suporte ao comportamento que a interface do Google Sala de Aula já tem. Por exemplo, a API não permite o uso obrigatório de rubricas em atividades nem substitui a capacidade de um professor de editar rubricas e envios, como é possível 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 usar a rubrica para avaliar. 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.

Outros escopos

As rubricas podem ser exportadas manualmente para as Planilhas Google para reutilização pelos professores.

Se você criar ou atualizar uma rubrica usando essas planilhas (confira um exemplo no guia), seu app 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.

Atividades de terceiros

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

Isso se aplica aos recursos criados pelos usuários no app Sala de Aula. Por exemplo, não é possível que um aplicativo gerencie rubricas de um trabalho do curso criado 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 Issue Tracker público.

Requisitos de licença

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

Consulte 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 Classroom para se familiarizar e solicitar uma conta de demonstração para desenvolvimento.

Anterior
Períodos de avaliação