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 dos professores no app Google Sala de Aula.

CourseWork e StudentSubmissions

No Google Sala de Aula, os estudantes entregam StudentSubmissions para as atividades de CourseWork na Course. CourseWork pode ser avaliado ou sem avaliação. Se uma CourseWork for avaliada, ela terá um valor maxPoints que representa o total de pontos que a atividade vale. Se maxPoints for zero ou não for especificado, a atividade será sem nota.

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

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

Atividades atrasadas, dispensadas e pendentes

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 uma dueDate na CourseWork, e as StudentSubmissions associadas são marcadas com um campo late (definido como true) se o estudante 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 do Google Sala de Aula como pendentes. Os professores também podem marcar envios como pendentes manualmente no app Google Sala de Aula. As atividades pendentes recebem automaticamente um draftGrade, que pode ser personalizado pelo professor, mas é definido como 0 por padrão.

As atividades pendentes podem ser marcadas como concluídas ou dispensadas pelo professor. StudentSubmissions marcadas como concluídas têm o campo draftGrade padrão removido até que o professor defina um novo manualmente. 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 lidar com as entregas.

Nota geral e sistemas de avaliação

O Google Sala de Aula aceita vários sistemas de avaliação para calcular as notas gerais dos estudantes em um curso. As notas gerais podem ser calculadas diretamente com base no total de pontos, ponderadas por categoria ou não calculadas.

Consulte o artigo Configurar avaliações 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 no seu próprio aplicativo quando possível. Por exemplo, se os estudantes não puderem ver a nota final no Google Sala de Aula, não mostre essa informação no seu 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 das atividades correspondentes.
• Se um curso usar 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 as ponderações de categoria forem 20% para dever de casa, 10% para problemas práticos e 70% para testes, mas não houver problemas práticos, o Google Sala de Aula vai ajustar as ponderações para ~22% para dever de casa e ~78% para testes ao calcular as notas finais. Se você pretende espelhar as notas gerais do Google Sala de Aula no seu aplicativo, precisará fazer o mesmo.

Períodos de avaliação

Os professores podem agrupar CourseWork atividades de um curso em diferentes períodos de datas chamados de períodos de avaliação. Os períodos de avaliação podem ser usados para filtrar os trabalhos na visualização do boletim e criar buckets distintos para os cálculos da nota final.

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

O sistema de notas 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 usava categorias de avaliação ponderada, 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 da primavera.
• A nota geral de todas as atividades no período de datas do outono.

Todas as três calculariam a nota final com categorias ponderadas.

Confira 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 de períodos de avaliação para saber como ler e gerenciar períodos de avaliação com a API.

Rubricas

Os professores podem criar e associar Rubrics a atividades de CourseWork e usar essas rubricas como um guia ao corrigir os 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 outros campos:

• rubricId identifica a rubrica que corresponde ao CourseWork do envio.
• draftRubricGrades representa os critérios e as notas provisórias que o professor criou antes de devolver a atividade ao estudante.
• assignedRubricGrades representa os critérios e as notas 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 oferece escalas de avaliação personalizáveis. Por exemplo, os professores podem traduzir notas numéricas em notas por letras. Essas configurações e os dados correspondentes não estão disponíveis na API.