Esta página lista alguns mal-entendidos comuns e casos extremos que você pode considerar ao projetar e implementar seu complemento do Google Sala de Aula. É recomendável implementar medidas de segurança contra falhas e testes que cubram esses casos.
Conceitos do Google Sala de Aula
Esta seção destaca casos extremos e conceitos relevantes para complementos usados no Google Sala de Aula.
Cursos e funções do usuário
Um curso é a unidade organizacional central que conecta professores e alunos. Os cursos são o nível mais alto de organização na API Google Classroom.
Os usuários individuais podem ser adicionados a um curso como "professores" ou "alunos". O papel de um usuário no curso não está vinculado à função dele na instituição. Isso significa que um estudante da escola pode ser professor em um curso, e os membros professores podem ser estudantes em cursos. Embora o caso mais comum seja que um curso represente uma disciplina acadêmica programada regularmente, os cursos também são criados para organizar clubes de estudantes ou realizar o desenvolvimento profissional.
As informações a seguir se aplicam a todos os cursos do Google Sala de Aula.
Em relação aos professores dos cursos:
- Um curso pode ter mais de um professor.
- Os professores podem ser adicionados a um curso a qualquer momento.
- Os professores podem ser removidos de um curso a qualquer momento.
Item de transmissão
Os itens do mural são conteúdos postados compartilhados com os participantes de um curso. Desenvolvedores e professores podem criar anexos de complementos em três tipos de itens do Stream: avisos, atividades e materiais.
Os professores criam avisos na parte superior da página "Mural" na interface do Google Sala de Aula. Os professores criam atividades e materiais clicando no botão Criar na guia "Atividades". Os desenvolvedores podem criar esses de forma programática usando a API Classroom.
Uma atividade é um item de transmissão que pode aceitar uma entrega do estudante. As atividades são o único tipo de item de transmissão que aparece na plataforma de avaliação e pode conter um anexo de complemento.
Em relação aos itens de streaming:
- Uma atividade ou um material pode ser atribuído a um subconjunto de alunos no curso.
- Uma atividade pode ter ou não ter nota. Os professores podem mudar o status de avaliação de uma atividade a qualquer momento.
- Uma atividade pode ter mais de um anexo.
- Uma atividade pode ter anexos de tipos diferentes. Por exemplo, uma atividade pode ter Documentos Google, vídeos do YouTube e anexos de complementos simultaneamente.
- Uma atividade pode ter anexos de complementos de mais de um desenvolvedor.
- Os desenvolvedores podem receber e modificar informações sobre qualquer item do mural com um dos anexos de complemento.
- Os desenvolvedores podem entregar, reivindicar ou devolver o envio de um estudante para uma atividade que inclua um dos anexos de complementos.
- Os desenvolvedores só podem definir notas para envios de estudantes individuais em atividades criadas por eles.
Itens de streaming copiados
Os professores podem copiar um item de transmissão copiando um curso, reutilizando uma atividade ou publicando um item de transmissão em vários cursos. Leia nosso guia sobre conteúdo copiado para entender como o complemento pode lidar com esses cenários.
Instituição do usuário
A API Google Sala de Aula não retorna identificadores para a instituição, o prédio ou qualquer outra associação do usuário acima do nível do curso.