Wersje robocze to niewysłane wiadomości z etykietą systemową DRAFT
.
Utworzonej wiadomości roboczej nie można edytować, ale można ją zastąpić. W tym sensie zasób wersji roboczej to po prostu kontener, który zapewnia stały identyfikator, ponieważ identyfikatory bazowe wiadomości zmieniają się przy każdym zastąpieniu wiadomości.
Zasoby wiadomości w wersji roboczej działają podobnie do innych wiadomości, z wyjątkiem tych różnic:
- Wersje robocze wiadomości nie mogą mieć żadnej etykiety innej niż etykieta systemowa
DRAFT
. - Po wysłaniu wersja robocza jest automatycznie usuwana i tworzona jest nowa wiadomość ze zaktualizowanym identyfikatorem z etykietą systemową
SENT
. Ta wiadomość jest zwracana w odpowiedzidrafts.send
.
Spis treści
Tworzenie wersji roboczych wiadomości
Aplikacja może tworzyć wersje robocze przy użyciu metody drafts.create. Ogólna procedura to:
- Utwórz wiadomość MIME zgodną ze standardem RFC 2822.
- Przekonwertuj wiadomość na ciąg zakodowany w standardzie base64url.
- Utwórz wersję roboczą, ustawiając wartość w polu
drafts.message.raw
na zakodowany ciąg znaków.
Poniższe przykłady kodu ilustrują ten proces.
Java
Python
Aktualizowanie wersji roboczych
Podobnie jak w przypadku wersji roboczej, aby zaktualizować wersję roboczą, należy podać w treści żądania zasób Draft
z polem draft.message.raw
ustawionym na ciąg zakodowany w standardzie base64url zawierający wiadomość MIME. Wiadomości nie można aktualizować, więc wiadomość w wersji roboczej jest niszczona i zastępowana nową wiadomością MIME dostarczoną w żądaniu aktualizacji.
Aktualną wiadomość MIME z wersji roboczej możesz pobrać, wywołując metodę drafts.get
z parametrem format=raw
.
Więcej informacji: drafts.update
.
Wysyłanie wersji roboczych
Wysyłając wersję roboczą, możesz zdecydować, czy chcesz wysłać wiadomość w takiej postaci, w jakiej jest, czy jak ze zaktualizowaną wiadomością. Jeśli aktualizujesz wersję roboczą wiadomości o nową wiadomość, podaj zasób Draft
w treści żądania drafts.send
. Ustaw wartość draft.id
wersji roboczej do wysłania i ustaw w polu draft.message.raw
nową wiadomość MIME zakodowaną jako ciąg zakodowany w standardzie base64url. Więcej informacji: drafts.send
.