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

Ce guide explique comment créer, répertorier 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.

Ce guide concerne la délégation d'accès aux contacts. Pour déléguer l'accès à Gmail, consultez Déléguer des e-mails et collaborer.

Prérequis

Avant d'utiliser l'API Contact Delegation, assurez-vous de remplir les conditions suivantes :

  • Activer le partage des contacts : un administrateur de l'annuaire doit activer le partage des contacts dans la console d'administration. Pour en savoir plus, consultez Activer ou désactiver le partage des contacts.
  • Droits d'administrateur : vous devez disposer du droit d'administrateur "Contacts" pour gérer les délégués d'autres utilisateurs.
  • Restriction de domaine : vous ne pouvez déléguer des contacts qu'entre des utilisateurs de la même organisation Google Workspace.
  • Champ d'application OAuth : votre application doit utiliser le champ d'application OAuth suivant : https://www.googleapis.com/auth/admin.contact.delegation.

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égateur :

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Remplacez USER_EMAIL par l'adresse e-mail du délégateur.

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

{
  "email": "DELEGATE_EMAIL"
}

Remplacez DELEGATE_EMAIL par l'adresse e-mail du délégué.

Si la requête aboutit, un code d'état HTTP 200 et l'e-mail du nouveau délégué sont renvoyés :

{
  "email": "DELEGATE_EMAIL"
}

Répertorier les délégués

Pour répertorier 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/USER_EMAIL/delegates

Remplacez USER_EMAIL par l'adresse e-mail de l'utilisateur.

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

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

Supprimer un délégué

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

  1. Identifiez le délégué à supprimer. Utilisez la méthode List delegates 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/USER_EMAIL/delegates/DELEGATE_EMAIL

Remplacez USER_EMAIL par l'adresse e-mail du délégateur et DELEGATE_EMAIL par l'adresse e-mail du délégué.

Si la requête aboutit, un code d'état HTTP 200 est renvoyé.