⚠️ Configuração avançada. Para Gmail recomendamos o tipo Gmail App Password, muito mais simples.
O Gmail OAuth2 só é aconselhado se tiver um técnico informático e uma conta Google Workspace:
- Em Google Workspace, a aplicação pode ser interna à sua organização e o acesso não expira.
- Em contas Gmail gratuitas, a aplicação fica em teste e a Google corta o acesso ao fim de 7 dias, obrigando a repetir o consentimento todas as semanas. A alternativa é publicar a aplicação e submetê-la à verificação da Google, um processo longo e exigente, pensado para empresas de software.
1. Criar a aplicação na Google Cloud
Com uma conta de administrador do Google Workspace, em console.cloud.google.com:
- Crie um projeto novo (por exemplo, “GC”).
- Em Google Auth Platform (ecrã de consentimento OAuth):
- Público-alvo / Audience: escolha Interno (Internal).
- Preencha o nome da aplicação e os e-mails de contacto.
- Em Acesso aos dados / Data access, adicione o âmbito
https://mail.google.com/.
- Em Clientes / Clients, crie um ID de cliente OAuth do tipo Aplicação Web.
- Em URIs de redirecionamento autorizados, cole o Redirect Uri que o GC mostra na conta (ver passo 2).
- Guarde o ID de cliente e o segredo do cliente.
2. Configurar no GC
Aceda a Administração >> Email >> Contas de Envio, clique em Adicionar e escolha o tipo Gmail OAuth2.
- Preencha Utilizador (o endereço Google), E-Mail: De, Nome, Client Id e Client Secret, e grave.
- Depois de gravar, o GC mostra o Redirect Uri: é este o endereço a registar na Google Cloud (passo 1.3).
- Clique em Consentimento, entre com a conta Google e autorize.
- Clique em Testar.
❓ Se deixar de funcionar
- Conta gratuita / aplicação em teste: o acesso expira ao fim de 7 dias — volte a clicar em Consentimento, ou mude para Gmail App Password.
- Segredo do cliente apagado ou trocado na Google Cloud: atualize o Client Secret no GC e dê Consentimento de novo.