Les étudiants et les enseignants sont des mappages spécifiques entre un profil utilisateur et un cours, et représentent le rôle de cet utilisateur dans le cours. La désignation des élèves et des enseignants n'est pas globale. Un utilisateur peut être désigné comme enseignant pour un cours et pour un élève dans un autre. La désignation "élève" ou "enseignant" représente un ensemble d'autorisations pour un utilisateur spécifique dans un cours particulier.
- Participants
- Une ressource "Student" représente un utilisateur inscrit en tant qu'étudiant à un cours spécifique. Les étudiants sont autorisés à afficher les détails du cours et les enseignants de ce cours.
- Enseignants
- Une ressource "Enseignant" représente un utilisateur qui donne un cours spécifique. Les enseignants peuvent afficher 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, tel que renvoyé par l'API Directory.
L'utilisateur actuel peut également faire référence à son propre ID à l'aide du raccourci "me"
.
Ajout direct
Les administrateurs de domaine sont autorisés à contourner le flux d'invitation et à ajouter directement les utilisateurs de leur domaine en tant qu'enseignants ou élèves aux cours de leur domaine. Un cours est considéré comme faisant partie du domaine de l'administrateur si son propriétaire appartient au domaine de l'administrateur. Pour les utilisateurs ou les cours n'appartenant pas au domaine d'un administrateur de domaine authentifié, les applications doivent obtenir le consentement de l'utilisateur en envoyant une invitation à l'aide de la méthode invitations.create()
.
Ajouter ou supprimer des enseignants
Les administrateurs de domaine peuvent ajouter directement des enseignants de leur domaine aux cours avec teachers.create()
, comme illustré dans l'exemple suivant:
.NET
Java
PHP
Python
Si vous ajoutez des enseignants supplémentaires pour le compte d'un enseignant authentifié, vous devez utiliser la méthode invitations.create()
.
Vous pouvez supprimer des enseignants d'un cours avec la méthode teachers.delete()
. Cela ne supprime que l'enseignant spécifié du cours et n'affecte pas son attribution aux autres cours ni son profil utilisateur.
Enregistrer ou supprimer des élèves
Les administrateurs de domaine peuvent ajouter directement des élèves au sein de 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 avec la méthode students.delete()
. Cette action supprime uniquement l'étudiant spécifié du cours et n'a aucune incidence sur son inscription aux 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é d'un utilisateur, y compris son ID et son nom, appelez userProfiles.get()
avec l'ID, l'adresse e-mail ou le "moi" de l'utilisateur à l'origine de la demande.
Pour récupérer le champ emailAddress
, vous devez inclure le champ d'application classroom.profile.emails
.
L'ID renvoyé correspond à la ressource Utilisateurs de l'API Directory, qui contient les valeurs studentId
ou teacherId
correspondantes.
Gérer les propriétaires de cours
Les administrateurs de domaine peuvent transférer la propriété des cours entre les enseignants. Pour en savoir plus, consultez la section Transférer la propriété d'un cours.