Configurare le impostazioni POP e IMAP con l'API Gmail

Questo documento spiega come gestire i protocolli POP e IMAP utilizzando l'API Gmail.

POP e IMAP sono due modi per leggere i messaggi di Gmail in altri client di posta. POP è un protocollo precedente progettato per un singolo computer. Con POP, il client scarica i messaggi e tu scegli la frequenza con cui scaricare quelli nuovi. IMAP funziona su più dispositivi e sincronizza i messaggi in tempo reale.

Puoi utilizzare la risorsa settings dell'API Gmail per configurare la gestione dei protocolli POP e IMAP da parte di Gmail:

POP

Puoi gestire le impostazioni POP per un account utilizzando l'oggetto PopSettings.

Attivare e disattivare l'accesso

Controlla l'accesso con il campo accessWindow. Questo campo determina se POP è abilitato e quali messaggi recupera l'API.

Valore Effetto
disabled Nessun messaggio è accessibile tramite POP
allMail Tutti i messaggi non recuperati sono accessibili tramite POP
fromNowOn Solo i nuovi messaggi sono accessibili tramite POP

Disposizione dei messaggi

Configura la disposizione dei messaggi recuperati dall'API con il campo disposition.

Valore Effetto
archive Spostare i messaggi fuori da INBOX
leaveInInbox Non fare nulla; lascia i messaggi da leggere in INBOX
markRead Lasciare messaggi in INBOX e contrassegnarli come letti
trash Spostare i messaggi in TRASH

IMAP

Puoi gestire le impostazioni IMAP per un account utilizzando l'oggetto ImapSettings.

Attivare e disattivare l'accesso

Utilizza il campo booleano enabled per controllare l'accesso. Questo campo determina se IMAP è abilitato per l'account.

Disposizione dei messaggi

Utilizza il campo expungeBehavior per configurare la disposizione di un messaggio quando un client lo contrassegna come eliminato e lo elimina dall'ultima cartella IMAP visibile.

Valore Effetto
archive Spostare i messaggi contrassegnati come eliminati fuori da INBOX
deleteForever Elimina definitivamente i messaggi contrassegnati come eliminati
trash Sposta i messaggi contrassegnati come eliminati in TRASH

Se il campo booleano autoExpunge è true, Gmail elimina immediatamente un messaggio quando un client lo contrassegna come eliminato in IMAP. In caso contrario, i messaggi rimangono finché il client IMAP non ne richiede esplicitamente la rimozione.