Gérer les délégués de contacts

Ce guide explique comment créer, lister et supprimer des délégués de contacts pour les utilisateurs Google Workspace.

Les utilisateurs Google Workspace peuvent autoriser d'autres utilisateurs de leur domaine à accéder à leurs contacts et à les gérer. Ces délégués peuvent ajouter des contacts et mettre à jour des informations telles que des noms, numéros de téléphone et adresses.

Créer un délégué

Pour créer un délégué pour un utilisateur, envoyez une requête POST avec l'adresse e-mail du délégant :

POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

Dans le corps de la requête, indiquez l'adresse e-mail du délégué :

{
  "email": "delegate@example.com"
}

Une réponse réussie renvoie un code d'état HTTP 200 et l'adresse e-mail du nouveau délégué :

{
  "email": "delegate@example.com"
}

Lister les délégués

Pour lister les délégués des contacts d'un utilisateur, envoyez une requête GET avec l'adresse e-mail de cet utilisateur :

GET https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

Si la requête aboutit, la réponse renvoie un code d'état HTTP 200 et une liste d'adresses e-mail de délégués :

{
  "delegates": [
    {
      "email": "delegate1@example.com"
    },
    {
      "email": "delegate2@example.com"
    }
  ]
}

Supprimer un délégué

Pour supprimer un délégué pour les contacts d'un utilisateur, procédez comme suit :

  1. Identifiez le délégué à supprimer. Utilisez la méthode List delegates (Lister les délégués) pour trouver l'adresse e-mail d'un délégué spécifique.

  2. Envoyez une requête DELETE avec les adresses e-mail du délégateur et du délégué :

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com

Une réponse réussie renvoie un code d'état HTTP 200.