Wersja robocza wiadomości utworzona przez użytkownika na koncie Gmail użytkownika.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
deleteDraft() | void | Usuwa tę wersję roboczą wiadomości. |
getId() | String | Pobiera identyfikator tej wersji roboczej wiadomości. |
getMessage() | GmailMessage | Zwraca wiadomość GmailMessage reprezentującą tę wersję roboczą. |
getMessageId() | String | Zwraca identyfikator elementu GmailMessage reprezentującego tę wersję roboczą. |
send() | GmailMessage | Wysyła tę wersję roboczą e-maila. |
update(recipient, subject, body) | GmailDraft | Zastępuje treść tej wiadomości roboczej. |
update(recipient, subject, body, options) | GmailDraft | Zastę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
Nazwa | Typ | Opis |
---|---|---|
recipient | String | rozdzielana przecinkami lista adresów e-mail |
subject | String | temat e-maila (maksymalnie 250 znaków) |
body | String | treść 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
Nazwa | Typ | Opis |
---|---|---|
recipient | String | rozdzielana przecinkami lista adresów e-mail |
subject | String | temat e-maila (maksymalnie 250 znaków) |
body | String | treść e-maila |
options | Object | obiekt JavaScript, który określa zaawansowane parametry, jak pokazano poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
from | String | adres, z którego ma zostać wysłany e-mail (musi to być jeden z nich)
wartości zwróconych przez funkcję GmailApp.getAliases() |
htmlBody | String | Jeś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. |
inlineImages | Object | obiekt 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" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika); |
replyTo | String | adres 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/