Les élèves et les enseignants sont des mises en correspondance spécifiques entre un profil utilisateur et un cours, et représentent le rôle de cet utilisateur dans le cours. Les rôles d'élève et d'enseignant ne sont pas globaux: un utilisateur peut être désigné comme enseignant pour un cours et comme élève pour un autre. La désignation "étudiant" ou "enseignant" représente un ensemble d'autorisations pour un utilisateur donné dans un cours donné.
- Étudiants
- Une ressource "Élève" représente un utilisateur inscrit en tant qu'élève dans un cours spécifique. Les élèves sont autorisés à consulter les détails du cours et les enseignants du cours.
- les enseignants.
- Une ressource "Enseignant" représente un utilisateur qui enseigne un cours spécifique. Les enseignants sont autorisés à consulter et à modifier les détails du cours, à afficher les enseignants et les élèves, et à gérer d'autres enseignants et élèves.
Les élèves et les enseignants sont identifiés par l'ID ou l'adresse e-mail unique de l'utilisateur, comme indiqué par l'API Directory.
L'utilisateur actuel peut également faire référence à son propre ID à l'aide de l'abréviation "me"
.
Ajout direct
Les administrateurs de domaine sont autorisés à contourner le flux d'invitation et à ajouter directement des utilisateurs de leur domaine en tant qu'enseignants ou élèves à des cours de leur domaine. Un cours est considéré comme appartenant au domaine de l'administrateur si le propriétaire du cours appartient au domaine de l'administrateur. Pour les utilisateurs ou les cours en dehors du domaine d'un administrateur de domaine authentifié, les applications doivent obtenir le consentement de l'utilisateur en envoyant une invitation avec la méthode invitations.create()
.
Ajouter ou supprimer des enseignants
Les administrateurs de domaine peuvent ajouter directement des enseignants de leur domaine à des cours avec teachers.create()
, comme illustré dans l'exemple suivant:
.NET
Java
PHP
Python
Si vous ajoutez d'autres enseignants au nom d'un enseignant authentifié, vous devez utiliser la méthode invitations.create()
.
Vous pouvez supprimer des enseignants supplémentaires d'un cours à l'aide de la méthode teachers.delete()
. Cette action ne supprime que l'enseignant spécifié du cours et n'a aucune incidence sur son attribution à d'autres cours ni sur son profil utilisateur.
Inscrire ou supprimer des élèves
Les administrateurs de domaine peuvent ajouter directement des élèves dans leur domaine à l'aide de la méthode students.create()
, comme illustré dans l'exemple suivant:
.NET
Java
PHP
Python
Si vous ajoutez des élèves au nom d'un enseignant authentifié, vous devez utiliser la méthode invitations.create()
.
Vous pouvez supprimer un élève d'un cours à l'aide de la méthode students.delete()
. Cette action ne supprime que l'étudiant spécifié du cours et n'a aucune incidence sur son inscription à d'autres cours ni sur son profil utilisateur.
Récupérer les cours d'un utilisateur
Pour récupérer la liste des cours d'un élève ou d'un enseignant, appelez courses.list()
et fournissez le studentId
ou le teacherId
de l'utilisateur correspondant.
Récupérer le profil d'un utilisateur
Pour récupérer le profil abrégé, y compris l'ID et le nom, d'un utilisateur, appelez userProfiles.get()
avec l'ID, l'adresse e-mail ou "moi" pour l'utilisateur à l'origine de la demande.
Pour récupérer le champ emailAddress
, vous devez inclure le champ classroom.profile.emails
.
L'ID renvoyé correspond à la ressource "Users" de l'API Directory contenant le studentId
ou le teacherId
correspondant.
Gérer les propriétaires de cours
Les administrateurs de domaine peuvent transférer la propriété de cours entre enseignants. Pour en savoir plus, consultez la section Transférer la propriété d'un cours.