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.

Si vous utilisez Google Workspace, vous pouvez autoriser d'autres utilisateurs de votre domaine à accéder à vos 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 contenant l'adresse e-mail du délégateur :

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 contenant 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é que vous souhaitez supprimer. Vous pouvez utiliser la méthode List delegates pour trouver l'adresse e-mail d'un délégué spécifique.

  2. Envoyez une requête DELETE contenant l'adresse e-mail du délégant 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.