Method: users.settings.delegates.create

Ajoute un délégué dont l'état de validation est défini directement sur accepted, sans envoyer d'e-mail de validation. L'utilisateur délégué doit appartenir à la même organisation Google Workspace que l'utilisateur délégant.

Gmail limite le nombre de délégués et de délégants que chaque utilisateur d'une organisation Google Workspace peut avoir. Ces limites dépendent de votre organisation, mais en général, chaque utilisateur peut avoir jusqu'à 25 délégataires et jusqu'à 10 délégateurs.

Notez qu'un utilisateur délégué doit être désigné par son adresse e-mail principale, et non par un alias d'adresse e-mail.

Notez également qu'un délai maximal d'une minute peut être nécessaire pour qu'un nouveau délégué soit disponible.

Cette méthode n'est disponible que pour les clients de comptes de service auxquels une autorité au niveau du domaine a été déléguée.

Requête HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
userId

string

Adresse e-mail de l'utilisateur. La valeur spéciale "me" permet d'indiquer l'utilisateur authentifié.

Corps de la requête

Le corps de la requête contient une instance de Delegate.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Delegate.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/gmail.settings.sharing

Pour en savoir plus, consultez le guide d'autorisation.