Nesta página, listamos alguns mal-entendidos comuns e casos extremos que você pode considerar ao criar 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 que se aplicam ao 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 de organização mais alto na API Google Classroom.
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 membro aluno da escola pode ser professor em um curso, e membros professores podem ser alunos em cursos. O caso mais comum é que um curso represente uma disciplina acadêmica programada regularmente, mas ele também é criado para organizar clubes estudantis ou conduzir desenvolvimento profissional.
As informações a seguir se aplicam a todos os cursos do Google Sala de Aula.
Com relação aos professores de 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 stream
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 item de 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 criá-los de forma programática usando a API Classroom.
Uma atividade é um item de fluxo que aceita o envio de um estudante. As atividades são o único tipo de item de fluxo que aparece no diário de classe que pode conter um anexo de complemento.
Com relação aos itens de stream:
- Uma atividade ou um material pode ser atribuído a um subconjunto de alunos no curso.
- Uma atividade pode receber ou não nota. Os professores podem mudar o status de avaliação de uma tarefa a qualquer momento.
- Uma atividade pode ter mais de um anexo.
- Uma atividade pode ter anexos de diferentes tipos. 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 de stream com um dos anexos de complementos.
- 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 nas atividades que criaram.
Itens de stream copiados
Os professores podem copiar um item de fluxo copiando um curso, reutilizando uma atividade ou publicando um item de fluxo em vários cursos. Leia nosso guia sobre conteúdo copiado para entender como o complemento pode lidar com esses casos.
Instituição do usuário
A API Google Classroom não retorna identificadores para a instituição, edifício ou qualquer outra associação de um usuário acima do nível do curso.