Method: courses.studentGroups.studentGroupMembers.list

Renvoie la liste des élèves d'un groupe.

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

  • NOT_FOUND si le cours ou le groupe d'élèves n'existent pas.

Requête HTTP

GET 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
pageSize

integer

Nombre maximal d'éléments à renvoyer. Si la valeur est nulle ou non spécifiée, le serveur peut attribuer un maximum.

Le serveur peut renvoyer un nombre de résultats inférieur à celui spécifié.
pageToken

string

Valeur nextPageToken renvoyée par un appel list précédent, indiquant que la page de résultats suivante doit être renvoyée.

La requête list doit être identique à celle qui a généré ce jeton.
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 doit être vide.

Corps de la réponse

Réponse lors de la liste des élèves d'un groupe.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "studentGroupMembers": [
    {
      object (StudentGroupMember)
    }
  ],
  "nextPageToken": string
}
Champs
studentGroupMembers[]

object (StudentGroupMember)

Les membres du groupe d'élèves.
nextPageToken

string

Jeton identifiant la page de résultats suivante à renvoyer. Si ce champ est vide, cela signifie qu'il n'y a plus de résultats.

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.rosters.readonly

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