Use as Configurações para configurar o encaminhamento de uma conta. Para ser usado como endereço de e-mail de encaminhamento, um endereço precisa atender a um dos seguintes critérios:
- O endereço de e-mail foi verificado. Para mais informações, consulte Como criar e verificar endereços de encaminhamento.
- O endereço de e-mail pertence ao mesmo domínio do remetente.
- O endereço de e-mail pertence a um subdomínio no mesmo domínio do remetente.
- O endereço de e-mail pertence a um alias de domínio configurado como parte da mesma conta do Google Workspace.
Se o endereço de e-mail de encaminhamento não aderir a uma dessas regras, a configuração do encaminhamento usando a API falhará.
Para mais informações sobre como criar, listar, receber ou excluir endereços de encaminhamento, consulte a referência encaminhamentoAddresses.
Para informações sobre como receber ou atualizar as configurações de encaminhamento, consulte a Referência de configurações.
Como criar e verificar endereços de encaminhamento
É necessário criar os endereços de encaminhamento antes de usar. Em alguns casos, os usuários também precisam verificar a propriedade do endereço.
Se o Gmail exigir a verificação do usuário para um endereço de encaminhamento, o endereço será retornado com o
status pending
. Uma mensagem de verificação é enviada automaticamente para o
endereço de e-mail de destino. O proprietário do endereço de e-mail precisa concluir o processo de verificação para que ele possa ser usado.
Os endereços de encaminhamento que não exigem verificação têm o status accepted
.
Como ativar o encaminhamento automático
Chame o método updateAutoForwarding para ativar o encaminhamento automático de uma conta. A chamada requer um endereço de encaminhamento registrado e verificado, bem como uma ação para as mensagens encaminhadas.
Por exemplo, se quiser ativar o encaminhamento automático e mover mensagens encaminhadas para a lixeira:
Java
Python
Para desativar o encaminhamento automático, chame updateAutoForwarding
e defina a propriedade enabled
como false
.
Como encaminhar mensagens específicas
O encaminhamento automático envia todas as mensagens recebidas para a conta de destino. Para encaminhar mensagens seletivamente, use filtros para criar regras que encaminham mensagens em resposta a atributos ou ao conteúdo das mensagens.