Wersje robocze to niewysłane wiadomości z etykietą systemową DRAFT
.
Po utworzeniu wiadomości nie można jej edytować, ale można ją zastąpić. W tym sensie zasob zasobu roboczego to po prostu kontener, który zapewnia stabilny identyfikator, ponieważ identyfikatory wiadomości zmieniają się za każdym razem, gdy wiadomość zostanie zastąpiona.
Zasoby wiadomości w wersji roboczej mają podobne działanie do innych wiadomości, z tymi wyjątkami:
- Wiadomości w postaci szkicu nie mogą mieć etykiety innej niż etykieta systemowa
DRAFT
. - Po wysłaniu wersji roboczej zostanie ona automatycznie usunięta, a nowa wiadomość z aktualnym identyfikatorem zostanie utworzona z etykietą systemu
SENT
. Ta wiadomość jest zwracana w odpowiedzidrafts.send
.
Spis treści
Tworzenie wersji roboczych wiadomości
Aplikacja może tworzyć wersje robocze za pomocą metody drafts.create. Ogólny proces obejmuje:
- Utwórz wiadomość MIME zgodną ze standardem RFC 2822.
- Przekształć wiadomość w ciąg znaków zakodowany w base64url.
- Utwórz wersję roboczą, ustawiając wartość pola
drafts.message.raw
na zakodowany ciąg znaków.
Poniżej znajdziesz przykłady kodu ilustrujące ten proces.
Java
Python
Aktualizowanie wersji roboczych
Podobnie jak w przypadku tworzenia wersji roboczej, aby zaktualizować wersję roboczą, musisz podać zasób Draft
w treści żądania, przy czym pole draft.message.raw
musi być ustawione na kodowany ciąg znaków base64url zawierający wiadomość MIME. Ponieważ wiadomości nie można zaktualizować, wiadomość zawarta w wersji roboczej zostanie zniszczona i zastąpiona nową wiadomością MIME przesłaną w żądaniu aktualizacji.
Możesz pobrać bieżącą wiadomość MIME zawartą w szkicu, wywołując funkcję drafts.get
z parametrem format=raw
.
Więcej informacji znajdziesz w sekcji drafts.update
.
Wysyłanie wersji roboczych
Podczas wysyłania wersji roboczej możesz zdecydować, czy chcesz wysłać wiadomość w postaci roboczej, czy zaktualizowanej. Jeśli aktualizujesz treść szkicu, dodając nową wiadomość, podaj zasób Draft
w treści żądania drafts.send
; ustaw draft.id
szkicu, który ma zostać wysłany; i ustaw pole draft.message.raw
na nową wiadomość MIME zakodowaną jako ciąg znaków w formacie base64url. Więcej informacji znajdziesz w sekcji drafts.send
.