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. Recomendamos a implementação de failsafes e testes que cubram esses casos.
Conceitos do Google Sala de Aula
Esta seção destaca casos extremos e conceitos relevantes para complementos que se aplicam a todo o 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 stream são os conteúdos postados e compartilhados com os membros 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 de cima 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 programaticamente 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 transmissão:
- Uma atividade ou material pode ser atribuído a um subconjunto de estudantes 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 anexos de complementos, vídeos do YouTube e documentos do Google 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, recuperar ou devolver o envio de um estudante para uma atividade que inclui um dos anexos do complemento.
- 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.