Les élèves et les enseignants sont des mappages spécifiques entre un profil utilisateur et un cours, qui représentent le rôle de cet utilisateur dans le cours. Les désignations d'élève et d'enseignant ne sont pas globales: un utilisateur peut être désigné comme enseignant pour un cours et comme élève pour un autre. La désignation "élève" ou "enseignant" représente un ensemble d'autorisations accordées à un utilisateur particulier dans un cours particulier.
- Étudiants
- Une ressource "Élève" représente un utilisateur inscrit en tant qu'étudiant à un cours spécifique. Les élèves sont autorisés à consulter les détails du cours et les enseignants qui lui sont associés.
- les enseignants.
- Une ressource "Enseignant" désigne un utilisateur qui enseigne un cours spécifique. Les enseignants sont autorisés à consulter et à modifier les détails du cours, à voir les enseignants et les élèves, et à gérer les enseignants et les élèves supplémentaires.
Les élèves et les enseignants sont identifiés par l'identifiant unique ou l'adresse e-mail de l'utilisateur, tel que renvoyé par l'API Directory.
L'utilisateur actuel peut également se référer à son propre identifiant à l'aide du raccourci "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 aux cours de leur domaine. Un cours est considéré comme relevant du domaine de l'administrateur si son propriétaire 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 à l'aide de la méthode invitations.create()
.
Ajouter ou supprimer des enseignants
Les administrateurs de domaine peuvent directement ajouter 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 au nom d'un enseignant authentifié, vous devez utiliser la méthode invitations.create()
.
Vous pouvez supprimer des enseignants supplémentaires d'un cours avec la méthode teachers.delete()
. Cette opération supprime uniquement l'enseignant spécifié du cours et n'a aucune incidence sur son affectation aux autres cours ni sur son profil utilisateur.
Inscrire ou exclure des élèves
Les administrateurs de domaine peuvent ajouter directement des élèves à 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 opération supprime uniquement 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 pour un élève ou 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 la mention "moi" pour le demandeur.
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 contenant le studentId
ou le teacherId
correspondant.
Gérer les propriétaires de cours
Les administrateurs de domaine peuvent transférer la propriété des cours d'un enseignant à un autre. Veuillez consulter la section Transférer la propriété d'un cours pour en savoir plus.