Notas

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

Consulte o artigo avaliar e acompanhar atividades para saber mais sobre as jornadas de avaliação de professores no app Google Sala de Aula.

Atividades acadêmicas e envios dos estudantes

No Google Sala de Aula, os estudantes entregam StudentSubmissions para as atividades CourseWork no Course. CourseWork pode ser classificada ou não classificada. Se uma CourseWork for avaliada, ela terá um valor maxPoints que representa o total de pontos da atividade. 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 Sala de Aula, um assignedGrade é definido automaticamente no StudentSubmission, com o mesmo valor do 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, justificadas e ausentes

Quando os itens CourseWork são atribuídos, o marcador de posição StudentSubmissions é criado 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 enviar 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 da 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 é definida como 0 por padrão.

As atividades pendentes podem ser marcadas como concluídas ou dispensadas 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 nota geral, incluindo os períodos de avaliação.

Consulte o artigo de ajuda Atribuir notas e devolver uma atividade para saber mais sobre como os professores podem processar as submissões.

Nota geral e sistemas de avaliação

O Google Sala de Aula é compatível com vários sistemas de avaliação para calcular as notas gerais 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 Classroom. É uma prática recomendada respeitar isso na sua própria plataforma, quando possível. Por exemplo, se os estudantes não puderem ver a nota final no Google Sala de Aula, não a mostre 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 da categoria fossem 20% para a lição de casa, 10% para exercícios e 70% para testes, mas nenhum exercício estivesse presente, o Google Sala de Aula ajustaria os pesos para cerca de 22% para a lição de casa e cerca de 78% para testes ao calcular as notas gerais. 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 as atividades CourseWork em um curso em diferentes intervalos de datas, 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 exemplo 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 geral de todas as atividades no período de 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 envio.

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 oferece suporte a escalas de avaliação personalizáveis, por exemplo, permitindo que os professores convertam notas numéricas em notas por letras. Essas configurações e os dados correspondentes não estão disponíveis na API.