Configurar as opções de POP e IMAP com a API Gmail

Este documento explica como gerenciar os protocolos POP e IMAP usando a API Gmail.

O POP e o IMAP são duas maneiras de ler mensagens do Gmail em outros clientes de e-mail. O POP é uma tecnologia mais antiga que só pode ser usada em um único computador. Os e-mails baseados em POP são baixados, e você decide a frequência com que novos e-mails serão baixados. O IMAP pode ser usado em vários dispositivos, e os e-mails são sincronizados em tempo real.

Use o recurso settings da API Gmail para configurar como o Gmail lida com os protocolos POP e IMAP:

POP

É possível gerenciar as configurações de POP de uma conta usando o objeto PopSettings.

Ativar e desativar o acesso

Controlar o acesso com o campo accessWindow. Esse campo determina se o POP está ativado e quais mensagens a API recupera.

Valor Efeito
disabled Nenhuma mensagem pode ser acessada pelo POP
allMail Todas as mensagens não buscadas podem ser acessadas pelo POP
fromNowOn Apenas as mensagens novas podem ser acessadas pelo POP

Disposição da mensagem

Configure a disposição das mensagens que a API recupera com o campo disposition.

Valor Efeito
archive Mover mensagens da INBOX
leaveInInbox Não faça nada e deixe as mensagens não lidas na INBOX.
markRead Deixar a mensagem na INBOX e marcar como lida
trash Mova a mensagem para a TRASH

IMAP

É possível gerenciar as configurações do IMAP de uma conta usando o objeto ImapSettings.

Ativar e desativar o acesso

Controlar o acesso com o campo booleano enabled. Esse campo determina se o IMAP está ativado para a conta.

Disposição da mensagem

Configure a disposição de uma mensagem quando ela for marcada como excluída e removida da última pasta IMAP visível com o campo expungeBehavior.

Valor Efeito
archive Mover mensagens marcadas como excluídas da INBOX
deleteForever Excluir permanentemente as mensagens marcadas como excluídas
trash Mover mensagens marcadas como excluídas para a TRASH

Se o campo booleano autoExpunge for true, o Gmail vai excluir imediatamente uma mensagem quando ela for marcada como excluída no IMAP. Caso contrário, as mensagens permanecem até que o cliente IMAP peça explicitamente a remoção delas.