Há duas maneiras de enviar e-mails usando a API Gmail:
- Você pode enviá-lo diretamente usando o
método
messages.send
. - É possível enviá-lo de um rascunho usando o
método
drafts.send
.
Os e-mails são enviados como strings codificadas em base64url dentro da propriedade raw
de um
recurso de mensagem. A análise de alto nível
para enviar um e-mail é:
- Crie o conteúdo do e-mail de alguma forma conveniente e codifique-o como um base64url.
- Crie um novo recurso de mensagem e defina a propriedade
raw
dele como base64url. que você acabou de criar. - Chame
messages.send
ou, se estiver enviando um rascunho,drafts.send
. para enviar a mensagem.
Os detalhes desse fluxo de trabalho podem variar de acordo com o cliente e linguagem de programação.
Como criar mensagens
A API Gmail exige mensagens de e-mail MIME em conformidade com RFC 2822 e codificados como strings base64url. Muitas linguagens de programação têm bibliotecas ou utilitários que simplificam o processo de criação e codificação mensagens. Os exemplos de código a seguir demonstram como criar uma mensagem MIME usando as bibliotecas de cliente das APIs do Google para várias linguagens.
Java
A criação de uma mensagem de e-mail pode ser bastante simplificada com o MimeMessage
.
no pacote javax.mail.internet
. O exemplo a seguir mostra como
para criar a mensagem de e-mail, incluindo os cabeçalhos:
A próxima etapa é codificar o MimeMessage
, instanciar um Message
e defina a string de mensagem codificada em base64url como o valor do
propriedade raw
.
Python
O exemplo de código a seguir demonstra a criação de uma mensagem MIME, a codificação para
uma string base64url e a atribuir ao campo raw
da Message
recurso:
Como criar mensagens com anexos
Criar uma mensagem com um anexo é como criar qualquer outra mensagem, mas o processo de fazer upload do arquivo como um arquivo MIME depende da linguagem de programação. O código a seguir os exemplos demonstram maneiras possíveis de criar uma mensagem MIME de várias partes com um anexo.
Java
O exemplo a seguir mostra como criar uma mensagem MIME de várias partes, a as etapas de codificação e atribuição são as mesmas acima.
Python
Semelhante ao exemplo anterior, este exemplo também lida com a codificação do
mensagem para base64url e a atribuir ao campo raw
do Message
recurso.
Como enviar mensagens
Depois de criar uma mensagem, você pode enviá-la informando-a no
corpo da solicitação de uma chamada para
messages.send
, conforme demonstrado
nos exemplos a seguir.
Java
Python
Se você estiver tentando enviar uma resposta e quiser que o e-mail seja conversado, verifique se:
- Os cabeçalhos
Subject
são correspondentes - Os cabeçalhos
References
eIn-Reply-To
seguem Padrão RFC 2822.
Para acessar informações sobre como enviar uma mensagem a partir de um rascunho, consulte Como criar rascunhos.