Method: courses.students.create

Ajoute un utilisateur en tant qu'élève d'un cours.

Les administrateurs de domaine peuvent ajouter directement des utilisateurs de leur domaine en tant qu'élèves aux cours de leur domaine. Les élèves peuvent 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 requête n'est pas autorisé à créer des élèves dans ce cours ou en cas d'erreurs 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 dans le cours.

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'étudiant. Cet identifiant peut être l'identifiant attribué par Classroom ou 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 l'utilisateur à l'origine de la demande dispose d'autorisations administratives 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 de 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 d'autorisation.