Principais considerações

Esta página lista alguns mal-entendidos comuns e casos extremos que você pode querer considerar ao criar e implementar o 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 a todos os recursos do Google Sala de Aula.

Cursos e funções do usuário

Um curso é a unidade organizacional central que conecta os professores aos alunos. Os cursos são o mais alto nível de organização no a API Google Classroom.

Usuários individuais podem ser adicionados a um curso como "professores" ou "estudantes". O no curso não está vinculada à função dele na instituição. Isso significa que um aluno membro da escola pode ser professor de um curso e professor membros podem ser estudantes em cursos. O caso mais comum é para um curso para representar uma disciplina acadêmica com programação regular, cursos também são criados para organizar clubes estudantis ou realizar 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 em três itens do mural tipos: avisos, tarefas e materiais.

Os professores criam avisos na parte superior da página "Mural" na Interface do Google Sala de Aula. Os professores criam tarefas e materiais Clique no botão Criar na guia "Atividades". Os desenvolvedores podem criar programaticamente, 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 podem conter anexos de complementos.

Com relação aos itens de stream:

  • Uma tarefa ou material pode ser atribuído a um subconjunto de alunos da neste curso.
  • Uma atividade pode receber ou não nota. Os professores podem mudar a nota status de uma tarefa a qualquer momento.
  • Uma atividade pode ter mais de um anexo.
  • Uma atividade pode ter anexos de diferentes tipos. Por exemplo, atividade pode ter Documentos Google, vídeos do YouTube e anexos de complementos ao mesmo tempo.
  • 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 os anexos de complementos.
  • Os desenvolvedores podem entregar, reivindicar ou devolver o trabalho de um estudante para um que inclua um anexo de complemento.
  • Os desenvolvedores só podem dar notas para os envios de estudantes individuais em as atribuições criadas.

Itens de stream copiados

Os professores podem copiar um item de um mural copiando um curso, reutilizando uma atividade ou publicar um item de stream em vários cursos. Leia nosso guia sobre conteúdo copiado. para entender como o complemento lida com essas situações.

Instituição do usuário

A API Google Classroom não retorna identificadores para a instituição de um usuário. ou qualquer outra associação acima do nível do curso.