Method: courses.studentGroups.create

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

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

  • PERMISSION_DENIED si l'utilisateur qui en fait la demande n'est pas autorisé à créer le groupe d'élèves ou en cas d'erreur d'accès.
  • NOT_FOUND si le cours n'existe pas ou si l'utilisateur à l'origine de la demande n'y a pas accès.
  • FAILED_PRECONDITION si la création du groupe d'élèves dépasserait le nombre maximal de groupes d'élèves par cours.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Obligatoire. Identifiant du cours.

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 StudentGroup.

Corps de la réponse

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

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.