Istnieją dwa sposoby wysyłania e-maili przy użyciu interfejsu Gmail API:
- Możesz je wysłać bezpośrednio za pomocą metody
messages.send
. - Możesz go wysłać z wersji roboczej za pomocą metody
drafts.send
.
E-maile są wysyłane jako ciągi zakodowane w base64url we właściwości raw
zasobu wiadomości. Ogólna procedura wysyłania e-maila
to:
- Utwórz treść e-maila w wygodny sposób i zakoduj ją jako ciąg base64url.
- Utwórz nowy zasób wiadomości i ustaw jego właściwość
raw
na utworzony przed chwilą ciąg base64url. - Zadzwoń pod numer
messages.send
lub, jeśli wysyłasz wersję roboczą, pod numerdrafts.send
, aby wysłać wiadomość.
Szczegóły tego przepływu pracy mogą się różnić w zależności od wybranej biblioteki klienta i języka programowania.
Tworzenie wiadomości
Interfejs Gmail API wymaga wiadomości e-mail w formacie MIME zgodnych ze standardem RFC 2822 i zakodowane w postaci ciągów base64url. Wiele języków programowania udostępnia biblioteki lub narzędzia, które upraszczają proces tworzenia i kodowania wiadomości MIME. Poniżej znajdziesz przykłady kodu, które pokazują, jak utworzyć wiadomość MIME za pomocą bibliotek klienta interfejsów API Google w różnych językach.
Java
Tworzenie e-maili można znacznie uprościć dzięki klasie MimeMessage
w pakiecie javax.mail.internet
. Poniższy przykład pokazuje, jak utworzyć e-maila z nagłówkami:
Następnym krokiem jest zakodowanie MimeMessage
, utworzenie instancji obiektu Message
i ustawienie ciągu wiadomości zakodowanego w base64url jako wartości właściwości raw
.
Python
Poniższa próbka kodu pokazuje, jak utworzyć wiadomość MIME, kodować ją do ciągu base64url i przypisać ją do pola raw
zasobu Message
:
Tworzenie wiadomości z załącznikami
Tworzenie wiadomości z załącznikiem jest podobne do tworzenia każdej innej wiadomości, ale proces przesyłania pliku jako wieloczęściowej wiadomości MIME zależy od języka programowania. Poniższe przykłady kodu ilustrują możliwe sposoby tworzenia wieloczęściowej wiadomości MIME z załącznikiem.
Java
Poniższy przykład pokazuje, jak utworzyć wieloczęściową wiadomość MIME. Etapy kodowania i przypisywania są takie same jak powyżej.
Python
Podobnie jak w poprzednim przykładzie, w tym przykładzie również kodowanie wiadomości w formacie base64url i przypisywanie jej do pola raw
zasobu Message
Wysyłanie wiadomości
Po utworzeniu wiadomości możesz ją wysłać, podając ją w treści żądania wywołania do messages.send
, jak pokazano w poniższych przykładach.
Java
Python
Jeśli próbujesz wysłać odpowiedź i chcesz, aby e-mail trafiał do wątku, upewnij się, że:
- Nagłówki
Subject
są takie same - Nagłówki
References
iIn-Reply-To
są zgodne ze standardem RFC 2822.
Informacje o wysyłaniu wiadomości z wersji roboczej znajdziesz w artykule Tworzenie wersji roboczych.