Class GmailDraft

GmailDraft

Wersja robocza wiadomości utworzona przez użytkownika na koncie Gmail użytkownika.

Metody

MetodaZwracany typKrótki opis
deleteDraft()voidUsuwa tę wersję roboczą wiadomości.
getId()StringPobiera identyfikator tej wersji roboczej wiadomości.
getMessage()GmailMessageZwraca wiadomość GmailMessage reprezentującą tę wersję roboczą.
getMessageId()StringZwraca identyfikator elementu GmailMessage reprezentującego tę wersję roboczą.
send()GmailMessageWysyła tę wersję roboczą e-maila.
update(recipient, subject, body)GmailDraftZastępuje treść tej wiadomości roboczej.
update(recipient, subject, body, options)GmailDraftZastępuje treść tej wersji roboczej wiadomości przy użyciu opcjonalnych argumentów.

Szczegółowa dokumentacja

deleteDraft()

Usuwa tę wersję roboczą wiadomości.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage(); // Throws exception.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

getId()

Pobiera identyfikator tej wersji roboczej wiadomości.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var draftId = draft.getId();
var draftById = GmailApp.getDraft(draftId);
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Powrót

String – identyfikator wersji roboczej,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

getMessage()

Zwraca wiadomość GmailMessage reprezentującą tę wersję roboczą.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var message = draft.getMessage();
Logger.log(message.getSubject());

Powrót

GmailMessage – wiadomość reprezentująca zawartość wersji roboczej.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

getMessageId()

Zwraca identyfikator elementu GmailMessage reprezentującego tę wersję roboczą.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var messageId = draft.getMessageId();
Logger.log(messageId == draft.getMessage().getId());

Powrót

String – identyfikator wiadomości,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

send()

Wysyła tę wersję roboczą e-maila. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var msg = draft.send(); // Send it
Logger.log(msg.getDate()); // Should be approximately the current timestamp

Powrót

GmailMessage – nowo wysłana wiadomość

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

update(recipient, subject, body)

Zastępuje treść tej wiadomości roboczej. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

// The code below will update a draft email with the current date and time.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

Parametry

NazwaTypOpis
recipientStringrozdzielana przecinkami lista adresów e-mail
subjectStringtemat e-maila (maksymalnie 250 znaków)
bodyStringtreść e-maila

Powrót

GmailDraft – nowa wersja robocza

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


update(recipient, subject, body, options)

Zastępuje treść tej wersji roboczej wiadomości przy użyciu opcjonalnych argumentów. E-mail może zawierać zwykły tekst lub treść HTML. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

// Update a draft email with a file from Google Drive attached as a PDF.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametry

NazwaTypOpis
recipientStringrozdzielana przecinkami lista adresów e-mail
subjectStringtemat e-maila (maksymalnie 250 znaków)
bodyStringtreść e-maila
optionsObjectobiekt JavaScript, który określa zaawansowane parametry, jak pokazano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
fromStringadres, z którego ma zostać wysłany e-mail (musi to być jeden z nich) wartości zwróconych przez funkcję GmailApp.getAliases()
htmlBodyStringJeśli jest ustawiony, będą go używać urządzenia, które potrafią renderować kod HTML wymaganego argumentu body; opcjonalne pole inlineImages można dodać w kodzie HTML treść, jeśli e-mail zawiera obrazy w tekście.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)

Powrót

GmailDraft – nowa wersja robocza

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też