Method: admin.contacts.v1.users.delegates.list

Liste les délégués d'un utilisateur donné.

Requête HTTP

GET https://admin.googleapis.com/admin/contacts/v1/{parent=users/*}/delegates

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Parent propriétaire de cette collection de délégués, au format suivant: users/{userId}, où userId correspond à l'adresse e-mail de l'utilisateur donné.

Paramètres de requête

Paramètres
pageSize

integer

Détermine le nombre de délégués renvoyés dans chaque réponse. Par exemple, si la demande définit

pageSize=1

et que l'utilisateur donné a deux délégués, la réponse comporte deux pages. La réponse

nextPageToken

possède le jeton de la deuxième page. Si cette règle n'est pas configurée, la taille de page par défaut est utilisée.
pageToken

string

Jeton de page permettant de spécifier la page suivante. Un utilisateur ayant plusieurs délégués dispose d'un

nextPageToken

dans la réponse. Dans votre demande de suivi visant à obtenir le prochain ensemble de délégués, saisissez le

nextPageToken

dans le champ

pageToken

dans la chaîne de requête.

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 qui ont la structure suivante :

Type de message de réponse permettant à un administrateur de lister les délégués d'un utilisateur donné.

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

object (Delegate)

Liste des délégués de l'utilisateur donné.
nextPageToken

string

Jeton permettant de récupérer les délégués de suivi d'un utilisateur donné. La

nextPageToken

est utilisée dans le champ

pageToken

dans la chaîne de requête.

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/admin.contact.delegation
  • https://www.googleapis.com/auth/admin.contact.delegation.readonly

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