Method: members.list

Récupère la liste paginée de tous les membres d'un groupe. Cette méthode expire au bout de 60 minutes. Pour en savoir plus, consultez Résoudre les problèmes liés aux codes d'erreur.

Requête HTTP

GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/members

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
groupKey

string

Identifie le groupe dans la requête API. La valeur peut être l'adresse e-mail du groupe, son alias ou l'ID unique du groupe.

Paramètres de requête

Paramètres
includeDerivedMembership

boolean

Permet de spécifier si les adhésions indirectes doivent être répertoriées. Valeur par défaut : "false".
maxResults

integer

Nombre maximal de résultats sur une page. La valeur maximale autorisée est de 200.
pageToken

string

Jeton permettant de spécifier la page suivante dans la liste.
roles

string

Le paramètre de requête roles vous permet de récupérer les membres du groupe par rôle. Les valeurs autorisées sont OWNER, MANAGER et MEMBER.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

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

Représentation JSON 
{
  "kind": string,
  "etag": string,
  "members": [
    {
      object (Member)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Type de ressource dont il s'agit.
etag

string

ETag de la ressource.
members[]

object (Member)

Liste des objets membres.
nextPageToken

string

Jeton utilisé pour accéder à la page suivante de ce résultat.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://apps-apis.google.com/a/feeds/groups/
  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.group.member
  • https://www.googleapis.com/auth/admin.directory.group.member.readonly
  • https://www.googleapis.com/auth/admin.directory.group.readonly

Pour en savoir plus, consultez le Guide relatif aux autorisations.