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 recursos CourseWork).
  • A rubrica consiste em critérios, que consistem em níveis. Uma rubrica precisa ter pelo menos um critério, e um critério precisa ter pelo menos um nível.
  • Os níveis podem ter pontuação ou não. Os níveis precisam ser totalmente avaliados ou não avaliados 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 que seja 0 ponto.
    • Se os níveis não tiverem pontuação, o campo "points" deverá 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 especial, precisam sempre ser 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, um envio de estudante avaliado com uma rubrica tem propriedades draftRubricGrades e assignedRubricGrades. Esses valores representam as notas da rubrica (níveis selecionados e pontuações) que o estudante recebe durante a avaliação, 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 classificar envios, mas é possível ler os envios classificados 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 ser pouco 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 corrigir um envio com uma rubrica:
    • Ignorar completamente a rubrica ao atribuir notas.
    • Substitua os pontos de um critério, independente dos pontos disponíveis nos níveis dele.
    • Selecione níveis para apenas um subconjunto de critérios.
    • Atribuir pontos a um critério sem selecionar um nível correspondente.
    • Substitua o total de pontos da atividade, independente dos pontos que viriam da rubrica.

Além disso, a API não é compatível com 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 nem substituir a capacidade de um professor de editar rubricas e envios como ele pode hoje.

Limitações durante a avaliação

Da mesma forma, há outras limitações na edição de rubricas depois que um professor começa a usar uma delas para dar notas. Depois que a avaliação é iniciada, só é possível fazer as seguintes edições:

  • É possível editar o texto dos títulos e descrições de critérios e níveis.
  • A ordem dos níveis pode mudar dentro dos critérios.

Outros escopos

As rubricas podem ser exportadas manualmente para as Planilhas Google e reutilizadas por professores.

Se você criar ou atualizar uma rubrica dessas planilhas (confira 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.

Trabalhos de terceiros

As rubricas só podem ser criadas pelo projeto do Google Cloud que criou o item CourseWork principal. 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 estende 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 escolar criado por um professor na interface do Google Sala de Aula, mesmo que o mesmo professor seja proprietário do aplicativo. Se isso limitar significativamente seu caso de uso, compartilhe feedback no rastreador de problemas 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 conhecer e solicitar uma conta de demonstração para desenvolvimento.

Anterior
Períodos de avaliação