Method: courses.students.create

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

string

Identifiant du cours dans lequel créer l'élève. Il peut s'agir de l'identifiant attribué par Classroom ou d'un alias.

Paramètres de requête

Paramètres
enrollmentCode

string

Code d'inscription du cours dans lequel créer l'élève. Ce code est obligatoire si userId correspond à l'utilisateur à l'origine de la demande. Il peut être omis si ce dernier dispose des autorisations d'administration nécessaires pour créer des élèves pour n'importe quel utilisateur.

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.