Notas

Este documento apresenta conceitos de avaliação relevantes para a API Classroom.

Consulte o artigo Avaliar e acompanhar atividades para saber mais sobre a jornada de avaliação dos professores no app Google Sala de Aula.

Atividades e envios

No Google Sala de Aula, os estudantes entregam StudentSubmissions nas atividades de CourseWork no Course. CourseWork pode ser classificada ou não classificada. Se uma CourseWork receber nota, ela terá um valor de maxPoints que representa quantos pontos no total a atividade vale. Se maxPoints for zero ou não for especificado, a atividade não terá nota.

Para atividades com nota, os professores definem uma nota draftGrade na StudentSubmission antes de devolver a atividade ao aluno. Quando o envio é retornado no app Google Sala de Aula, um assignedGrade é definido automaticamente no StudentSubmission, com o mesmo valor que o draftGrade atual. Os desenvolvedores podem definir esses dois campos e precisam emular o comportamento do app Sala de Aula. Por exemplo, um assignedGrade não pode ser definido sem um draftGrade. Ambos os campos são representados com números decimais e, se não forem definidos, implicam que o professor ainda não definiu a nota correspondente. Consulte criar e gerenciar notas para conferir exemplos de código de leitura, configuração e retorno de notas.

Os estudantes podem enviar várias atividades para a mesma atividade CourseWork, e o estado do envio e o histórico de notas são rastreados em StudentSubmission.submissionHistory.

Atividades atrasadas, dispensadas e ausentes

Quando os itens CourseWork são atribuídos, os marcadores de posição StudentSubmissions são criados para cada estudante, mesmo que ele não tenha interagido com a atividade correspondente. Os professores podem definir um dueDate na CourseWork, e as StudentSubmissions associadas são marcadas com um campo late (definido como true) se o aluno não entregar a atividade antes da data. Os professores também podem desativar os envios atrasados com uma configuração no app Google Sala de Aula.

Além disso, as StudentSubmissions que não forem enviadas antes de dueDate serão anotadas no boletim de notas do Google Sala de Aula como pendentes. Os professores também podem marcar os envios como pendentes manualmente no app Google Sala de Aula. As atividades pendentes recebem automaticamente uma draftGrade, que pode ser personalizada pelo professor, mas é padrão 0.

Os envios ausentes podem ser marcados como concluídos ou justificados pelo professor. O campo draftGrade padrão de StudentSubmissionss marcadas como concluídas é removido até que o professor defina um novo manualmente. As StudentSubmissions marcadas como dispensadas são removidas dos cálculos da pontuação geral, incluindo os períodos de avaliação.

Consulte o artigo de ajuda Avaliar e devolver uma atividade para saber mais sobre como os envios podem ser gerenciados pelos professores.

Nota geral e sistemas de avaliação

O Google Sala de Aula tem vários sistemas para calcular as notas finais dos estudantes no curso. As notas gerais podem ser calculadas diretamente a partir do total de pontos, ponderadas por categoria ou não calculadas.

Consulte o artigo Configurar a avaliação para saber mais sobre os diferentes sistemas de avaliação com exemplos.

Alguns pontos importantes:

• O recurso Course tem um objeto gradebookSettings com detalhes sobre as configurações de nota do curso.
  • calculationType especifica o método de cálculo do curso.
  • displaySettings especifica quem pode ver as notas gerais no app Google Sala de Aula. É uma prática recomendada respeitar isso no seu próprio aplicativo, quando possível. Por exemplo, se os alunos não conseguirem ver a nota final deles no Google Sala de Aula, não mostre-a no app.
  • gradeCategories contém uma lista das categorias de avaliação configuradas para o curso, incluindo os nomes de exibição, a porcentagem de ponderação e os pontos padrão para as atividades correspondentes.
• Se um curso usa a avaliação ponderada, talvez seja necessário normalizar os pesos em cenários em que uma categoria não está presente. Por exemplo, se os pesos das categorias forem de 20% para o dever de casa, 10% para exercícios e 70% para testes, mas nenhum exercício estiver presente, o Google Sala de Aula ajustará os pesos para cerca de 22% para o dever de casa e 78% para testes no cálculo das notas finais. Se você quiser espelhar as notas gerais do Google Sala de Aula no seu aplicativo, faça o mesmo.

Períodos de avaliação

Os professores podem agrupar CourseWork atividades de um curso em períodos diferentes, chamados de períodos de avaliação. Os períodos de avaliação podem ser usados para filtrar o trabalho do curso na visualização do boletim de notas e criar buckets distintos para cálculos de notas gerais.

Por exemplo, um professor pode criar períodos de avaliação de semestres "primavera" e "outono". A nota geral do período da primavera só incluiria StudentSubmissions devido no período da primavera.

O sistema de avaliação definido para o curso se estende aos períodos de avaliação. Portanto, se os períodos de avaliação de primavera e outono mencionados acima fossem definidos em um curso que usasse categorias de avaliação ponderadas, haveria três conjuntos de notas gerais para os estudantes:

• A nota geral de todas as atividades do curso.
• A nota geral de todas as atividades no período de primavera.
• A nota final de todas as atividades no período do outono.

Todos os três calculariam a nota final com categorias ponderadas.

Consulte o anúncio sobre os períodos de avaliação para ter uma visão geral do recurso.

Os períodos de avaliação estendem CourseWork com um gradingPeriodId que identifica o período de avaliação em que a atividade se enquadra.

Consulte o guia da API Grading Periods para saber como ler e gerenciar períodos de avaliação com a API.

Rubricas

Os professores podem criar e associar Rubrics a atividades CourseWork e usar essas rubricas como guia ao avaliar as StudentSubmissions correspondentes.

Consulte o artigo sobre rubricas para saber como os professores podem usar rubricas no Google Sala de Aula.

As rubricas estendem o recurso StudentSubmissions com campos adicionais:

• rubricId identifica a rubrica que corresponde ao CourseWork do envio.
• draftRubricGrades representa os critérios e as pontuações de marcador de posição que o professor definiu antes de devolver a atividade ao estudante.
• assignedRubricGrades representa os critérios e as pontuações que o estudante recebe depois que o professor devolve o trabalho.

Consulte o guia da API de rubricas para saber como gerenciar rubricas e ler notas relacionadas com a API.

Escalas de avaliação

O Google Sala de Aula é compatível com escalas de avaliação personalizáveis, por exemplo, permitindo que os professores traduzam notas numéricas em notas com letras. Essas configurações e os dados correspondentes não estão disponíveis na API.