É possível conectar clientes e apps de e-mail de terceiros ao Gmail usando os protocolos IMAP e POP padrão para receber e-mails e o protocolo SMTP para enviar e-mails. Todos os três servidores são compatíveis com autenticação e autorização usando o OAuth 2.0.
Protocolo de autenticação
O IMAP, o POP e o SMTP usam a Camada de Autenticação e Segurança Simples (SASL) padrão, com os comandos integrados AUTHENTICATE do IMAP, AUTH do POP e AUTH do SMTP para autenticar usuários. O
formato SASL XOAUTH2 permite que os clientes forneçam credenciais do OAuth 2.0 para
autenticação. A documentação do protocolo SASL XOAUTH2 descreve o formato SASL XOAUTH2 em detalhes, e as bibliotecas e amostras do OAuth 2.0 estão disponíveis para implementar o protocolo.
Endereços e portas do servidor
Use os seguintes endereços e portas de servidor para receber e enviar e-mails:
| Protocolo | Direção | Endereço do servidor | Porta | Criptografia |
|---|---|---|---|---|
| IMAP | Entrada (receber) | imap.gmail.com |
993 |
SSL/TLS implícito |
| POP | Entrada (receber) | pop.gmail.com |
995 |
SSL/TLS implícito |
| SMTP | Saída (envio) | smtp.gmail.com |
465 |
SSL/TLS implícito |
| SMTP | Saída (envio) | smtp.gmail.com |
587 |
TLS (STARTTLS) |
As conexões de entrada com imap.gmail.com:993 e pop.gmail.com:995, bem como as conexões de saída com smtp.gmail.com:465, exigem SSL/TLS implícito. Se o
cliente SMTP começar com texto simples antes de emitir o comando STARTTLS para
fazer upgrade da conexão, use smtp.gmail.com:587.
Use smtp.gmail.com para enviar e-mails de um cliente ou app de e-mail em nome de um
usuário autenticado. Se você é um administrador do Google Workspace que encaminha
e-mails enviados de um servidor, uma impressora, um scanner ou um app local (por exemplo,
usando smtp-relay.gmail.com), consulte Enviar e-mails de uma impressora, um scanner ou um
app.
Limites de duração da sessão
As sessões POP do Gmail duram até aproximadamente 7 dias. As sessões IMAP do Gmail duram até aproximadamente 24 horas. Se você autenticou a sessão usando credenciais do OAuth, ela dura aproximadamente o período de validade do token de acesso usado (geralmente uma hora). Uma sessão nesse contexto é uma conexão contínua do protocolo TCP.
Quando o tempo se esgota e a sessão expira, o Gmail fecha a conexão com uma mensagem informando que a sessão expirou. Depois disso, o cliente pode se reconectar, autenticar novamente e continuar. Se estiver usando o OAuth 2.0, verifique se o token de acesso usado é válido. Se você tentar usar um token de acesso com mais de uma hora, ele pode ser inválido.
Limites de envio e largura de banda
Para manter o bom funcionamento dos sistemas e proteger as contas, o Gmail aplica limites diários de envio de e-mails e de largura de banda em um período contínuo de 24 horas. É possível enviar até 2.000 mensagens por dia de uma conta paga do Google Workspace e até 500 mensagens por dia de uma conta de teste do Google Workspace ou de uma conta pessoal do Gmail, com até 100 destinatários por mensagem enviada por SMTP por clientes POP ou IMAP. Esses limites são por usuário e compartilhados entre todos os clientes que acessam a conta. Para ver todos os detalhes, consulte:
- Limites de envio do Gmail no Google Workspace
- Limites de envio e recebimento de e-mails (contas pessoais do Gmail)
- Limites de largura de banda do Gmail
Bibliotecas e amostras
Para maior conveniência, os desenvolvedores costumam acessar e-mails usando IMAP ou POP e enviar e-mails usando SMTP com as bibliotecas IMAP e SMTP atuais. Desde que essas bibliotecas ofereçam suporte ao SASL, elas serão compatíveis com o formato SASL XOAUTH2 aceito pelo Gmail.
Além da documentação do protocolo SASL XOAUTH2, leia também Como usar o OAuth 2.0 para acessar as APIs do Google para mais informações sobre como implementar um cliente OAuth 2.0.
A página Bibliotecas e exemplos do OAuth 2.0 oferece exemplos de código em várias linguagens conhecidas usando o formato SASL XOAUTH2 com IMAP ou SMTP.