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 é um protocolo mais antigo projetado para um único computador. Com o POP, seu cliente baixa as mensagens, e você escolhe a frequência com que novas mensagens serão baixadas. O IMAP funciona em vários dispositivos e sincroniza mensagens 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 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 no INBOX.
markRead Deixar mensagens na INBOX e marcá-las como lidas
trash Mover mensagens para a TRASH

IMAP

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

Ativar e desativar o acesso

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

Disposição da mensagem

Use o campo expungeBehavior para configurar a disposição de uma mensagem quando um cliente a marca como excluída e a remove da última pasta IMAP visível.

Valor Efeito
archive Remover da INBOX as mensagens marcadas como excluídas
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 um cliente a marcar como excluída no IMAP. Caso contrário, as mensagens permanecem até que o cliente IMAP peça explicitamente a remoção delas.