Method: courses.studentGroups.studentGroupMembers.create

Crée un membre de groupe d'élèves pour un groupe d'élèves.

Cette méthode renvoie les codes d'erreur suivants :

  • PERMISSION_DENIED si l'utilisateur qui envoie la demande n'est pas autorisé à créer le groupe d'élèves ou le membre pour les erreurs d'accès.
  • NOT_FOUND si le groupe d'élèves n'existe pas ou si l'utilisateur n'y a pas accès.
  • ALREADY_EXISTS si le membre du groupe d'élèves existe déjà.
  • FAILED_PRECONDITION si vous essayez d'ajouter un membre à un groupe d'élèves qui a atteint sa limite de membres.

Requête HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Obligatoire. Identifiant du cours.
studentGroupId

string

Obligatoire. Identifiant du groupe d'élèves.

Paramètres de requête

Paramètres
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. Ce paramètre doit être défini pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.

Corps de la requête

Le corps de la requête contient une instance de StudentGroupMember.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de StudentGroupMember.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.rosters

Pour en savoir plus, consultez le guide d'autorisation.