- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Ajoute un utilisateur en tant qu'élève d'un cours.
Les administrateurs de domaine sont autorisés à ajouter directement aux cours de leur domaine des utilisateurs de leur domaine en tant qu'élèves. Les élèves sont autorisés à s'inscrire à un cours à l'aide d'un code d'inscription.
Cette méthode renvoie les codes d'erreur suivants:
PERMISSION_DENIED
si l'utilisateur à l'origine de la demande n'est pas autorisé à créer des élèves dans ce cours ou en cas d'erreur d'accès.NOT_FOUND
si l'ID de cours demandé n'existe pas.FAILED_PRECONDITION
si le compte de l'utilisateur demandé est désactivé, pour les erreurs de requête suivantes :- CourseMemberLimitReached
- CourseNotModifiable
- UserGroupsMembershipLimitReached
- InactiveCourseOwner
ALREADY_EXISTS
si l'utilisateur est déjà élève ou enseignant.
Requête HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/students
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
courseId |
Identifiant du cours dans lequel créer l'élève. Il peut s'agir de l'identifiant attribué par Classroom ou d'un |
Paramètres de requête
Paramètres | |
---|---|
enrollmentCode |
Code d'inscription du cours dans lequel créer l'élève. Ce code est obligatoire si |
Corps de la requête
Le corps de la requête contient une instance Student
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Student
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/classroom.rosters
https://www.googleapis.com/auth/classroom.profile.emails
https://www.googleapis.com/auth/classroom.profile.photos
Pour en savoir plus, consultez le guide relatif aux autorisations.