E-maile możesz wysyłać za pomocą interfejsu Gmail API na 2 sposoby:
- Możesz wysłać go bezpośrednio za pomocą metody
messages.send
. - Możesz wysłać go z wersji roboczej, korzystając z metody
drafts.send
.
E-maile są wysyłane jako ciągi zakodowane w standardzie base64url w ramach właściwości raw
zasobu wiadomości. Ogólny proces wysyłania e-maila wygląda tak:
- Utwórz treść e-maila w wygodny sposób i zakoduj ją jako ciąg znaków base64url.
- Utwórz nowy zasób wiadomości i ustaw jego właściwość
raw
na utworzony przed chwilą ciąg znaków 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 MIME zgodnych z RFC 2822 i zakodowanych jako ciągi base64url. Wiele języków programowania ma biblioteki lub narzędzia, które upraszczają proces tworzenia i kodowania wiadomości MIME. Poniższe przykłady kodu pokazują, jak utworzyć wiadomość MIME za pomocą bibliotek klienta interfejsów API Google w różnych językach.
Java
Tworzenie wiadomości e-mail można znacznie uprościć za pomocą klasy MimeMessage
w pakiecie javax.mail.internet
. Poniższy przykład pokazuje, jak utworzyć wiadomość e-mail, w tym nagłówki:
Następnym krokiem jest zakodowanie MimeMessage
, utworzenie instancji obiektu Message
i ustawienie zakodowanego w base64url ciągu znaków wiadomości jako wartości właściwości raw
.
Python
Poniższy przykładowy kod pokazuje, jak utworzyć wiadomość MIME, zakodować ją do postaci ciągu base64url i przypisać 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 pokazują możliwe sposoby tworzenia wieloczęściowej wiadomości MIME z załącznikiem.
Java
Poniższy przykład pokazuje, jak utworzyć wieloczęściową wiadomość MIME. Kroki kodowania i przypisywania są takie same jak powyżej.
Python
Podobnie jak w poprzednim przykładzie, ten przykład również obsługuje 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 messages.send
, jak pokazano w tych przykładach.
Java
Python
Jeśli chcesz wysłać odpowiedź i zależy Ci na tym, aby e-mail był częścią wątku, upewnij się, że:
- Nagłówki
Subject
są zgodne - 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.