Method: members.list

Récupère une 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. Il peut s'agir de l'adresse e-mail du groupe, de son alias ou de son ID unique.

Paramètres de requête

Paramètres
includeDerivedMembership

boolean

Permet de répertorier ou non les adhésions indirectes. 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)

Une liste des objets membre.
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.