Estudantes e professores são mapeamentos específicos entre um perfil de usuário e um curso, representando a função 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 como aluno em outro. A designação "estudante" ou "professor" representa um conjunto de permissões para um determinado usuário em um curso específico.
- Estudantes
- Um recurso "Student" representa um usuário que está inscrito como aluno em um curso específico. Estudantes têm permissão para ver os detalhes do curso e os professores desse curso.
- Professores
- Um recurso para professores representa um usuário que ministra um curso específico. Os professores podem ver e mudar os detalhes do curso, ver professores e estudantes e gerenciar outros professores e estudantes.
Estudantes e professores são identificados pelo ID exclusivo ou endereço de e-mail do
usuário, conforme retornado pela
API Directory.
O usuário atual também pode fazer referência ao próprio ID usando a abreviação "me"
.
Adição direta
Os administradores do domínio podem ignorar o fluxo de convite e adicionar diretamente usuários no domínio como professores ou alunos aos cursos dentro do domínio. Um curso é considerado dentro do domínio do administrador se o proprietário dele
está 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 do domínio a 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()
.
Para remover outros professores de um curso, use o método teachers.delete()
. Isso remove apenas o professor
especificado do curso e não afeta a atribuição dele a outros cursos ou
o perfil de usuário.
Registrar ou remover estudantes
Os administradores do domínio podem adicionar estudantes diretamente no domínio com o método
students.create()
, conforme mostrado no exemplo a seguir:
.NET
Java
PHP
Python
Se você estiver adicionando estudantes em nome de um professor autenticado, precisará usar
o método invitations.create()
.
Você pode remover um aluno de um curso com o método students.delete()
. Isso remove apenas o estudante
especificado do curso e não afeta a inscrição em outros cursos ou
o perfil de usuário.
Recuperar os cursos de um usuário
Para recuperar uma lista de cursos de um estudante 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, chame userProfiles.get()
com o ID do usuário, e-mail ou "mim" para o usuário solicitante.
Para recuperar o campo emailAddress
, é preciso incluir o escopo classroom.profile.emails
.
O ID retornado corresponde ao
recurso de usuários da API Directory
que contém o studentId
ou o 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 a propriedade do curso para ver detalhes importantes.