Alunos e professores são mapeamentos específicos entre um perfil de usuário e um curso, representando o papel desse usuário no curso. As designações de aluno e professor não são globais: um usuário pode ser designado como professor em um curso e em um aluno em outro. A designação "aluno" ou "professor" representa um conjunto de permissões para um usuário específico em um determinado curso.
- Estudantes
- Um recurso de aluno representa um usuário que está inscrito como um aluno em um curso específico. Os alunos podem ver os detalhes do curso e os professores desse curso.
- Professores
- Um recurso "Professor" representa um usuário que ministra um curso específico. Os professores podem ver e alterar os detalhes do curso, ver os professores e alunos e gerenciar outros professores e alunos.
Os alunos e professores são identificados pelo código exclusivo ou pelo endereço de e-mail do usuário, conforme retornado pela API Directory.
O usuário atual também pode referenciar o próprio ID usando a abreviação "me"
.
Adição direta
Os administradores do domínio podem ignorar o fluxo do convite e adicionar diretamente os usuários no domínio deles como professores ou alunos aos cursos no domínio. Um curso será considerado no domínio do administrador se o proprietário do curso estiver no domínio do administrador. Para usuários ou cursos fora do domínio de um administrador de domínio autenticado, os aplicativos precisam receber o consentimento do usuário enviando um convite com o método invitations.create()
.
Adicionar ou remover professores
Os administradores do domínio podem adicionar diretamente os professores no domínio aos cursos com teachers.create()
, conforme mostrado no exemplo a seguir:
.NET
Java
PHP
Python
Se você estiver adicionando outros professores em nome de um professor autenticado,
use o método invitations.create()
.
Você pode remover professores adicionais de um curso com o método teachers.delete()
. Isso apenas remove o professor especificado do curso e não afeta a atribuição dele a outros cursos ou seu perfil de usuário.
Inscrever ou remover alunos
Os administradores de domínio podem adicionar alunos diretamente no domínio com o método students.create()
, conforme mostrado no exemplo a seguir:
.NET
Java
PHP
Python
Se você estiver adicionando alunos em nome de um professor autenticado, use
o método invitations.create()
.
Você pode remover um aluno de um curso com o método students.delete()
. Isso apenas remove o aluno especificado do curso e não afeta a inscrição em outros cursos ou seu perfil de usuário.
Recuperar os cursos de um usuário
Para recuperar uma lista de cursos para um aluno ou professor, chame courses.list()
e forneça o studentId
ou teacherId
do usuário correspondente.
Recuperar o perfil de um usuário
Para recuperar o perfil resumido, incluindo o ID e o nome, de um usuário, chame userProfiles.get()
com o ID, e-mail ou "eu" do usuário que fez a solicitação.
Para recuperar o campo emailAddress
, inclua o escopo classroom.profile.emails
.
O código retornado corresponde ao recurso de usuários da API Directory que contém o studentId
ou teacherId
correspondente.
Gerenciar proprietários do curso
Os administradores do domínio podem transferir a propriedade dos cursos entre os professores. Consulte a seção Transferir propriedade do curso para ver detalhes importantes.