Vous pouvez configurer le transfert pour un compte à l'aide des paramètres. Pour être utilisée comme adresse e-mail de transfert, elle doit remplir l'un des critères suivants:
- L'adresse e-mail a été vérifiée. Pour en savoir plus, consultez la page Créer et valider des adresses de transfert.
- L'adresse e-mail appartient au même domaine que l'expéditeur.
- L'adresse e-mail appartient à un sous-domaine appartenant au même domaine que l'expéditeur.
- L'adresse e-mail appartient à un alias de domaine configuré dans le même compte Google Workspace.
Si l'adresse e-mail de transfert ne respecte pas l'une de ces règles, la configuration du transfert à l'aide de l'API échoue.
Pour en savoir plus sur la façon de créer, répertorier, get ou supprimer des adresses de transfert, consultez la documentation de référence sur TransfertAddresses.
Pour savoir comment obtenir ou mettre à jour les paramètres de transfert, consultez la documentation de référence sur les paramètres.
Créer et valider des adresses de transfert
Vous devez créer des adresses de transfert avant de les utiliser. Dans certains cas, les utilisateurs doivent également valider la propriété de l'adresse.
Si Gmail requiert la validation de l'utilisateur pour une adresse de transfert, celle-ci est renvoyée avec l'état pending
. Un message de validation est automatiquement envoyé à l'adresse e-mail cible. Le propriétaire de l'adresse e-mail doit terminer la procédure de validation avant de pouvoir l'utiliser.
Les adresses de transfert qui ne nécessitent pas de validation sont associées à l'état de validation accepted
.
Activer le transfert automatique
Appelez la méthode updateAutoForwarding pour activer le transfert automatique pour un compte. L'appel nécessite une adresse de transfert enregistrée et validée, ainsi qu'une action à effectuer sur les messages transférés.
Par exemple, pour activer le transfert automatique et placer les messages transférés dans la corbeille:
Java
Python
Pour désactiver le transfert automatique, appelez updateAutoForwarding et définissez la propriété enabled
sur false
.
Transférer des messages spécifiques
Le transfert automatique envoie tous les messages reçus au compte cible. Pour transférer des messages de manière sélective, utilisez des filtres afin de créer des règles qui transfèrent des messages en réponse aux attributs ou au contenu du message.