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 être membre de la même organisation Google Workspace que le délégateur.

Gmail impose des limites concernant le nombre de délégués et de délégués 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égués et 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 que lorsqu'un nouveau délégué est créé, un délai d'une minute peut être nécessaire avant qu'il ne soit disponible.

Cette méthode n'est disponible que pour les clients de compte de service qui disposent d'une autorité déléguée au niveau du domaine.

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 "moi" peut être utilisée pour indiquer l'utilisateur authentifié.

Corps de la requête

Le corps de la requête contient une instance 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 relatif aux autorisations.