Configurer les paramètres POP et IMAP avec l'API Gmail

Ce document explique comment gérer les protocoles POP et IMAP à l'aide de l'API Gmail.

POP et IMAP sont deux protocoles qui permettent de lire vos messages Gmail dans d'autres clients de messagerie. POP est une technologie plus ancienne qui ne peut être utilisée que sur un seul ordinateur. Les e-mails POP sont téléchargés à la fréquence de votre choix. IMAP peut être utilisé sur plusieurs appareils et les e-mails sont synchronisés en temps réel.

Vous pouvez utiliser la ressource settings de l'API Gmail pour configurer la façon dont Gmail gère les protocoles POP et IMAP :

POP

Vous pouvez gérer les paramètres POP d'un compte à l'aide de l'objet PopSettings.

Activer et désactiver l'accès

Contrôlez l'accès avec le champ accessWindow. Ce champ détermine si le protocole POP est activé et quels messages l'API récupère.

Valeur Effet
disabled Aucun message n'est accessible via POP
allMail Tous les messages non récupérés sont accessibles via POP.
fromNowOn Seuls les nouveaux messages sont accessibles via POP.

Disposition des messages

Configurez l'état des messages récupérés par l'API à l'aide du champ disposition.

Valeur Effet
archive Déplacer des messages hors de INBOX
leaveInInbox Ne rien faire : laisser les messages non lus dans INBOX
markRead Laisser le message dans INBOX et le marquer comme lu
trash Déplacer le message vers TRASH

IMAP

Vous pouvez gérer les paramètres IMAP d'un compte à l'aide de l'objet ImapSettings.

Activer et désactiver l'accès

Contrôlez l'accès avec le champ booléen enabled. Ce champ détermine si IMAP est activé pour le compte.

Disposition des messages

Configurez le traitement d'un message lorsqu'il est marqué comme supprimé et expurgé du dernier dossier IMAP visible à l'aide du champ expungeBehavior.

Valeur Effet
archive Retirer les messages marqués comme supprimés de la INBOX
deleteForever Supprimer définitivement les messages marqués comme supprimés
trash Déplacer les messages marqués comme supprimés vers la TRASH

Si le champ booléen autoExpunge est défini sur true, Gmail supprime immédiatement un message lorsqu'il est marqué comme supprimé dans IMAP. Sinon, les messages sont conservés jusqu'à ce que le client IMAP demande explicitement leur suppression.